@decionis/agentsafe 0.2.4 → 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 (320) hide show
  1. package/README.md +135 -20
  2. package/dist/Cli.js +20 -0
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +22 -5
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +19 -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 +91 -0
  46. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -0
  47. package/dist/adapters/mcp/McpGuard.js +147 -0
  48. package/dist/adapters/mcp/McpGuard.js.map +1 -0
  49. package/dist/adapters/mcp/McpIntentBinder.d.ts +54 -0
  50. package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -0
  51. package/dist/adapters/mcp/McpIntentBinder.js +79 -0
  52. package/dist/adapters/mcp/McpIntentBinder.js.map +1 -0
  53. package/dist/adapters/mcp/McpInvocation.d.ts +55 -0
  54. package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -0
  55. package/dist/adapters/mcp/McpInvocation.js +88 -0
  56. package/dist/adapters/mcp/McpInvocation.js.map +1 -0
  57. package/dist/audit/HashChain.d.ts +8 -2
  58. package/dist/audit/HashChain.d.ts.map +1 -1
  59. package/dist/audit/HashChain.js +14 -2
  60. package/dist/audit/HashChain.js.map +1 -1
  61. package/dist/boundary/BoundaryIdentity.d.ts +88 -0
  62. package/dist/boundary/BoundaryIdentity.d.ts.map +1 -0
  63. package/dist/boundary/BoundaryIdentity.js +126 -0
  64. package/dist/boundary/BoundaryIdentity.js.map +1 -0
  65. package/dist/cli/Commands.d.ts +1 -1
  66. package/dist/cli/Commands.d.ts.map +1 -1
  67. package/dist/cli/Commands.js +10 -0
  68. package/dist/cli/Commands.js.map +1 -1
  69. package/dist/cli/Edge.d.ts +4 -0
  70. package/dist/cli/Edge.d.ts.map +1 -0
  71. package/dist/cli/Edge.js +250 -0
  72. package/dist/cli/Edge.js.map +1 -0
  73. package/dist/cli/Help.d.ts.map +1 -1
  74. package/dist/cli/Help.js +9 -0
  75. package/dist/cli/Help.js.map +1 -1
  76. package/dist/cli/Host.d.ts +36 -0
  77. package/dist/cli/Host.d.ts.map +1 -0
  78. package/dist/cli/Host.js +247 -0
  79. package/dist/cli/Host.js.map +1 -0
  80. package/dist/cli/Identity.d.ts +47 -0
  81. package/dist/cli/Identity.d.ts.map +1 -0
  82. package/dist/cli/Identity.js +145 -0
  83. package/dist/cli/Identity.js.map +1 -0
  84. package/dist/cli/TcpBrokerCli.d.ts +4 -0
  85. package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
  86. package/dist/cli/TcpBrokerCli.js +93 -0
  87. package/dist/cli/TcpBrokerCli.js.map +1 -0
  88. package/dist/cli/TcpClientCli.d.ts +16 -0
  89. package/dist/cli/TcpClientCli.d.ts.map +1 -0
  90. package/dist/cli/TcpClientCli.js +175 -0
  91. package/dist/cli/TcpClientCli.js.map +1 -0
  92. package/dist/cli/TestCommand.d.ts +8 -0
  93. package/dist/cli/TestCommand.d.ts.map +1 -1
  94. package/dist/cli/TestCommand.js +25 -5
  95. package/dist/cli/TestCommand.js.map +1 -1
  96. package/dist/config/ConfigKeys.d.ts +2 -2
  97. package/dist/config/ConfigKeys.d.ts.map +1 -1
  98. package/dist/config/ConfigKeys.js +19 -0
  99. package/dist/config/ConfigKeys.js.map +1 -1
  100. package/dist/config/ExecutorConfig.d.ts +62 -0
  101. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  102. package/dist/config/ExecutorConfig.js +124 -0
  103. package/dist/config/ExecutorConfig.js.map +1 -1
  104. package/dist/edge/EdgeLicence.d.ts +25 -0
  105. package/dist/edge/EdgeLicence.d.ts.map +1 -0
  106. package/dist/edge/EdgeLicence.js +42 -0
  107. package/dist/edge/EdgeLicence.js.map +1 -0
  108. package/dist/edge/EdgeReplay.d.ts +45 -0
  109. package/dist/edge/EdgeReplay.d.ts.map +1 -0
  110. package/dist/edge/EdgeReplay.js +69 -0
  111. package/dist/edge/EdgeReplay.js.map +1 -0
  112. package/dist/edge/Entitlement.d.ts +57 -0
  113. package/dist/edge/Entitlement.d.ts.map +1 -0
  114. package/dist/edge/Entitlement.js +139 -0
  115. package/dist/edge/Entitlement.js.map +1 -0
  116. package/dist/edge/EntitlementEvaluation.d.ts +66 -0
  117. package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
  118. package/dist/edge/EntitlementEvaluation.js +74 -0
  119. package/dist/edge/EntitlementEvaluation.js.map +1 -0
  120. package/dist/edge/UsageCount.d.ts +40 -0
  121. package/dist/edge/UsageCount.d.ts.map +1 -0
  122. package/dist/edge/UsageCount.js +140 -0
  123. package/dist/edge/UsageCount.js.map +1 -0
  124. package/dist/edge/UsageKeyRegistration.d.ts +34 -0
  125. package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
  126. package/dist/edge/UsageKeyRegistration.js +74 -0
  127. package/dist/edge/UsageKeyRegistration.js.map +1 -0
  128. package/dist/edge/UsageMeter.d.ts +89 -0
  129. package/dist/edge/UsageMeter.d.ts.map +1 -0
  130. package/dist/edge/UsageMeter.js +275 -0
  131. package/dist/edge/UsageMeter.js.map +1 -0
  132. package/dist/edge/UsagePeriod.d.ts +23 -0
  133. package/dist/edge/UsagePeriod.d.ts.map +1 -0
  134. package/dist/edge/UsagePeriod.js +31 -0
  135. package/dist/edge/UsagePeriod.js.map +1 -0
  136. package/dist/edge/UsageReport.d.ts +92 -0
  137. package/dist/edge/UsageReport.d.ts.map +1 -0
  138. package/dist/edge/UsageReport.js +153 -0
  139. package/dist/edge/UsageReport.js.map +1 -0
  140. package/dist/edge/UsageTally.d.ts +63 -0
  141. package/dist/edge/UsageTally.d.ts.map +1 -0
  142. package/dist/edge/UsageTally.js +89 -0
  143. package/dist/edge/UsageTally.js.map +1 -0
  144. package/dist/egress/EgressError.d.ts +7 -1
  145. package/dist/egress/EgressError.d.ts.map +1 -1
  146. package/dist/egress/EgressError.js.map +1 -1
  147. package/dist/egress/EgressPolicy.d.ts +16 -3
  148. package/dist/egress/EgressPolicy.d.ts.map +1 -1
  149. package/dist/egress/EgressPolicy.js +33 -3
  150. package/dist/egress/EgressPolicy.js.map +1 -1
  151. package/dist/egress/GuardedFetch.d.ts +38 -1
  152. package/dist/egress/GuardedFetch.d.ts.map +1 -1
  153. package/dist/egress/GuardedFetch.js +52 -7
  154. package/dist/egress/GuardedFetch.js.map +1 -1
  155. package/dist/egress/TcpClient.d.ts +103 -0
  156. package/dist/egress/TcpClient.d.ts.map +1 -0
  157. package/dist/egress/TcpClient.js +490 -0
  158. package/dist/egress/TcpClient.js.map +1 -0
  159. package/dist/egress/TcpControlClient.d.ts +49 -0
  160. package/dist/egress/TcpControlClient.d.ts.map +1 -0
  161. package/dist/egress/TcpControlClient.js +186 -0
  162. package/dist/egress/TcpControlClient.js.map +1 -0
  163. package/dist/gateway/AuthorityAttacks.d.ts +39 -0
  164. package/dist/gateway/AuthorityAttacks.d.ts.map +1 -0
  165. package/dist/gateway/AuthorityAttacks.js +158 -0
  166. package/dist/gateway/AuthorityAttacks.js.map +1 -0
  167. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  168. package/dist/gateway/ForwardHandler.js +7 -4
  169. package/dist/gateway/ForwardHandler.js.map +1 -1
  170. package/dist/gateway/Gateway.d.ts +197 -10
  171. package/dist/gateway/Gateway.d.ts.map +1 -1
  172. package/dist/gateway/Gateway.js +524 -63
  173. package/dist/gateway/Gateway.js.map +1 -1
  174. package/dist/gateway/GatewayConfig.d.ts +78 -0
  175. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  176. package/dist/gateway/GatewayConfig.js +167 -2
  177. package/dist/gateway/GatewayConfig.js.map +1 -1
  178. package/dist/gateway/GatewayReport.d.ts +31 -1
  179. package/dist/gateway/GatewayReport.d.ts.map +1 -1
  180. package/dist/gateway/GatewayReport.js +12 -0
  181. package/dist/gateway/GatewayReport.js.map +1 -1
  182. package/dist/gateway/InterceptedRequest.d.ts +9 -2
  183. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  184. package/dist/gateway/InterceptedRequest.js +41 -9
  185. package/dist/gateway/InterceptedRequest.js.map +1 -1
  186. package/dist/gateway/RateLimit.d.ts +29 -0
  187. package/dist/gateway/RateLimit.d.ts.map +1 -0
  188. package/dist/gateway/RateLimit.js +33 -0
  189. package/dist/gateway/RateLimit.js.map +1 -0
  190. package/dist/gateway/RefusalSampler.d.ts +28 -0
  191. package/dist/gateway/RefusalSampler.d.ts.map +1 -0
  192. package/dist/gateway/RefusalSampler.js +52 -0
  193. package/dist/gateway/RefusalSampler.js.map +1 -0
  194. package/dist/gateway/RouteTable.d.ts +3 -0
  195. package/dist/gateway/RouteTable.d.ts.map +1 -1
  196. package/dist/gateway/RouteTable.js +44 -7
  197. package/dist/gateway/RouteTable.js.map +1 -1
  198. package/dist/gateway/Upstream.d.ts +26 -0
  199. package/dist/gateway/Upstream.d.ts.map +1 -1
  200. package/dist/gateway/Upstream.js +41 -2
  201. package/dist/gateway/Upstream.js.map +1 -1
  202. package/dist/gateway/UpstreamProof.d.ts +235 -0
  203. package/dist/gateway/UpstreamProof.d.ts.map +1 -0
  204. package/dist/gateway/UpstreamProof.js +375 -0
  205. package/dist/gateway/UpstreamProof.js.map +1 -0
  206. package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
  207. package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
  208. package/dist/handlers/ForwardRequestHandler.js +12 -2
  209. package/dist/handlers/ForwardRequestHandler.js.map +1 -1
  210. package/dist/hosted/TenantHost.d.ts +180 -0
  211. package/dist/hosted/TenantHost.d.ts.map +1 -0
  212. package/dist/hosted/TenantHost.js +432 -0
  213. package/dist/hosted/TenantHost.js.map +1 -0
  214. package/dist/hosted/TenantRegistry.d.ts +73 -0
  215. package/dist/hosted/TenantRegistry.d.ts.map +1 -0
  216. package/dist/hosted/TenantRegistry.js +123 -0
  217. package/dist/hosted/TenantRegistry.js.map +1 -0
  218. package/dist/http/ExecutorHttpServer.d.ts +7 -0
  219. package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
  220. package/dist/http/ExecutorHttpServer.js +30 -5
  221. package/dist/http/ExecutorHttpServer.js.map +1 -1
  222. package/dist/http/GatewayHttpServer.d.ts +55 -3
  223. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  224. package/dist/http/GatewayHttpServer.js +157 -17
  225. package/dist/http/GatewayHttpServer.js.map +1 -1
  226. package/dist/http/RedirectServer.d.ts +26 -0
  227. package/dist/http/RedirectServer.d.ts.map +1 -0
  228. package/dist/http/RedirectServer.js +62 -0
  229. package/dist/http/RedirectServer.js.map +1 -0
  230. package/dist/http/Routes.d.ts +17 -0
  231. package/dist/http/Routes.d.ts.map +1 -1
  232. package/dist/http/Routes.js +21 -0
  233. package/dist/http/Routes.js.map +1 -1
  234. package/dist/http/TcpBroker.d.ts +57 -0
  235. package/dist/http/TcpBroker.d.ts.map +1 -0
  236. package/dist/http/TcpBroker.js +299 -0
  237. package/dist/http/TcpBroker.js.map +1 -0
  238. package/dist/http/TcpHostRelay.d.ts +24 -0
  239. package/dist/http/TcpHostRelay.d.ts.map +1 -0
  240. package/dist/http/TcpHostRelay.js +194 -0
  241. package/dist/http/TcpHostRelay.js.map +1 -0
  242. package/dist/http/TcpRelayStreams.d.ts +24 -0
  243. package/dist/http/TcpRelayStreams.d.ts.map +1 -0
  244. package/dist/http/TcpRelayStreams.js +128 -0
  245. package/dist/http/TcpRelayStreams.js.map +1 -0
  246. package/dist/http/TlsListener.d.ts +3 -1
  247. package/dist/http/TlsListener.d.ts.map +1 -1
  248. package/dist/http/TlsListener.js +7 -2
  249. package/dist/http/TlsListener.js.map +1 -1
  250. package/dist/identity/PrincipalsFile.d.ts +3 -1
  251. package/dist/identity/PrincipalsFile.d.ts.map +1 -1
  252. package/dist/identity/PrincipalsFile.js +1 -0
  253. package/dist/identity/PrincipalsFile.js.map +1 -1
  254. package/dist/incident/Metrics.d.ts +2 -0
  255. package/dist/incident/Metrics.d.ts.map +1 -1
  256. package/dist/incident/Metrics.js +10 -0
  257. package/dist/incident/Metrics.js.map +1 -1
  258. package/dist/incident/SecurityEvents.d.ts +89 -0
  259. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  260. package/dist/incident/SecurityEvents.js +93 -2
  261. package/dist/incident/SecurityEvents.js.map +1 -1
  262. package/dist/journal/ExecutionJournal.d.ts +27 -0
  263. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  264. package/dist/journal/ExecutionJournal.js +28 -0
  265. package/dist/journal/ExecutionJournal.js.map +1 -1
  266. package/dist/journal/FileExecutionJournal.d.ts +2 -1
  267. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  268. package/dist/journal/FileExecutionJournal.js +4 -1
  269. package/dist/journal/FileExecutionJournal.js.map +1 -1
  270. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  271. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  272. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  273. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  274. package/dist/provenance/DockerProvenanceProvider.d.ts +23 -0
  275. package/dist/provenance/DockerProvenanceProvider.d.ts.map +1 -0
  276. package/dist/provenance/DockerProvenanceProvider.js +24 -0
  277. package/dist/provenance/DockerProvenanceProvider.js.map +1 -0
  278. package/dist/provenance/KubernetesProvenanceProvider.d.ts +17 -0
  279. package/dist/provenance/KubernetesProvenanceProvider.d.ts.map +1 -0
  280. package/dist/provenance/KubernetesProvenanceProvider.js +18 -0
  281. package/dist/provenance/KubernetesProvenanceProvider.js.map +1 -0
  282. package/dist/provenance/NoneProvenanceProvider.d.ts +15 -0
  283. package/dist/provenance/NoneProvenanceProvider.d.ts.map +1 -0
  284. package/dist/provenance/NoneProvenanceProvider.js +16 -0
  285. package/dist/provenance/NoneProvenanceProvider.js.map +1 -0
  286. package/dist/provenance/ProvenanceProvider.d.ts +94 -0
  287. package/dist/provenance/ProvenanceProvider.d.ts.map +1 -0
  288. package/dist/provenance/ProvenanceProvider.js +118 -0
  289. package/dist/provenance/ProvenanceProvider.js.map +1 -0
  290. package/dist/provenance/StaticProvenanceProvider.d.ts +18 -0
  291. package/dist/provenance/StaticProvenanceProvider.d.ts.map +1 -0
  292. package/dist/provenance/StaticProvenanceProvider.js +25 -0
  293. package/dist/provenance/StaticProvenanceProvider.js.map +1 -0
  294. package/dist/service/AuthorityClients.d.ts +8 -1
  295. package/dist/service/AuthorityClients.d.ts.map +1 -1
  296. package/dist/service/AuthorityClients.js +33 -5
  297. package/dist/service/AuthorityClients.js.map +1 -1
  298. package/dist/service/EdgeRuntime.d.ts +73 -0
  299. package/dist/service/EdgeRuntime.d.ts.map +1 -0
  300. package/dist/service/EdgeRuntime.js +209 -0
  301. package/dist/service/EdgeRuntime.js.map +1 -0
  302. package/dist/service/EscalationResolver.d.ts +82 -2
  303. package/dist/service/EscalationResolver.d.ts.map +1 -1
  304. package/dist/service/EscalationResolver.js +39 -3
  305. package/dist/service/EscalationResolver.js.map +1 -1
  306. package/dist/service/Requests.d.ts +28 -2
  307. package/dist/service/Requests.d.ts.map +1 -1
  308. package/dist/service/TrustedExecutorService.d.ts +71 -1
  309. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  310. package/dist/service/TrustedExecutorService.js +461 -27
  311. package/dist/service/TrustedExecutorService.js.map +1 -1
  312. package/dist/tcp/TcpWire.d.ts +18 -0
  313. package/dist/tcp/TcpWire.d.ts.map +1 -0
  314. package/dist/tcp/TcpWire.js +114 -0
  315. package/dist/tcp/TcpWire.js.map +1 -0
  316. package/dist/verify/VerifyAuditChain.d.ts +5 -0
  317. package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
  318. package/dist/verify/VerifyAuditChain.js +20 -4
  319. package/dist/verify/VerifyAuditChain.js.map +1 -1
  320. package/package.json +7 -3
@@ -0,0 +1,126 @@
1
+ import { createHash } from "node:crypto";
2
+ /**
3
+ * Which enforcement boundary this process is.
4
+ *
5
+ * An estate may run hundreds of gateways across Docker, Kubernetes, a Linux
6
+ * host and the hosted runtime. A Decision Dossier that names the boundary can
7
+ * answer which of them admitted an effect; one that cannot is evidence about
8
+ * an action with no evidence about the door it came through.
9
+ *
10
+ * The identity is of the *configured logical boundary*, not of the process or
11
+ * the container: restarting a container, rescheduling a pod or scaling a
12
+ * deployment to thirty replicas leaves it unchanged, because nothing
13
+ * ephemeral goes into it. That is also why the derivation below reads
14
+ * configuration rather than the machine: a boundary id that moved when a pod
15
+ * did would be an instance id wearing a boundary's name, and an operator
16
+ * grouping policy by boundary would be grouping by nothing.
17
+ */
18
+ /** The conformance profile this boundary answers for. */
19
+ export const BOUNDARY_CONFORMANCE = "agent-safe-intent-v1";
20
+ export const BOUNDARY_PROTOCOL = "agent-safe.intent/1";
21
+ /** A derived id wears a prefix so it is never mistaken for one an operator chose. */
22
+ export const DERIVED_BOUNDARY_PREFIX = "bd_";
23
+ export const BOUNDARY_ENVIRONMENT = {
24
+ boundaryId: "AGENTSAFE_BOUNDARY_ID",
25
+ clusterId: "AGENTSAFE_CLUSTER_ID",
26
+ namespace: "AGENTSAFE_NAMESPACE",
27
+ region: "AGENTSAFE_REGION",
28
+ workloadId: "AGENTSAFE_WORKLOAD_ID",
29
+ containerId: "AGENTSAFE_CONTAINER_ID",
30
+ podId: "AGENTSAFE_POD_ID",
31
+ nodeId: "AGENTSAFE_NODE_ID",
32
+ };
33
+ /**
34
+ * The shape a value must have to be one of these. A variable holding anything
35
+ * else is no value rather than a guess, the same way an unrecognised
36
+ * `AGENTSAFE_SURFACE` is no surface.
37
+ */
38
+ const TOKEN = /^[a-z0-9][\w.:/-]*$/i;
39
+ const MAX_TOKEN = 200;
40
+ function token(value) {
41
+ const trimmed = value?.trim();
42
+ // An empty string needs no test of its own: the pattern requires a first
43
+ // character, so `""` fails it like any other malformed value.
44
+ if (trimmed === undefined || trimmed.length > MAX_TOKEN)
45
+ return null;
46
+ return TOKEN.test(trimmed) ? trimmed : null;
47
+ }
48
+ function present(value) {
49
+ return Object.values(value).some((entry) => entry !== null) ? value : null;
50
+ }
51
+ /**
52
+ * The separator between the derivation's parts. It is not decoration: two
53
+ * different configurations must not be able to join into the same string.
54
+ */
55
+ const DERIVATION_SEPARATOR = "\n";
56
+ /**
57
+ * A boundary nobody named, from the settings that define what it is: what it
58
+ * was installed as, which deployment it serves, and what it stands in front
59
+ * of. Two gateways configured alike are the same boundary and share an id;
60
+ * one pointed at a different upstream or a different environment is a
61
+ * different boundary and does not. No hostname, address, user or container id
62
+ * reaches the digest, so the id is stable across restarts and carries nothing
63
+ * about the host into evidence.
64
+ *
65
+ * The derivation is a compatibility contract, pinned by a vector in the
66
+ * tests: changing it would silently re-partition the evidence of every
67
+ * deployment that never named its boundary.
68
+ */
69
+ function derive(facts) {
70
+ const material = [
71
+ facts.deploymentType ?? "unknown",
72
+ facts.environment ?? "",
73
+ facts.upstreamOrigin ?? "",
74
+ ].join(DERIVATION_SEPARATOR);
75
+ const digest = createHash("sha256").update(material).digest("hex");
76
+ return `${DERIVED_BOUNDARY_PREFIX}${digest.slice(0, 16)}`;
77
+ }
78
+ export function resolveBoundary(facts) {
79
+ const named = token(facts.env[BOUNDARY_ENVIRONMENT.boundaryId]) ?? token(facts.configuredId ?? undefined);
80
+ return {
81
+ boundaryId: named ?? derive(facts),
82
+ boundarySource: named === null ? "derived" : "configured",
83
+ agentsafeVersion: facts.version,
84
+ protocolVersion: BOUNDARY_PROTOCOL,
85
+ conformanceVersion: BOUNDARY_CONFORMANCE,
86
+ deploymentType: facts.deploymentType ?? "unknown",
87
+ environment: token(facts.environment ?? undefined),
88
+ placement: present({
89
+ clusterId: token(facts.env[BOUNDARY_ENVIRONMENT.clusterId]),
90
+ namespace: token(facts.env[BOUNDARY_ENVIRONMENT.namespace]),
91
+ region: token(facts.env[BOUNDARY_ENVIRONMENT.region]),
92
+ workloadId: token(facts.env[BOUNDARY_ENVIRONMENT.workloadId]),
93
+ }),
94
+ instance: present({
95
+ containerId: token(facts.env[BOUNDARY_ENVIRONMENT.containerId]),
96
+ podId: token(facts.env[BOUNDARY_ENVIRONMENT.podId]),
97
+ nodeId: token(facts.env[BOUNDARY_ENVIRONMENT.nodeId]),
98
+ }),
99
+ };
100
+ }
101
+ /**
102
+ * The boundary as an intent binds it. The instance is left out deliberately:
103
+ * what reaches signed evidence is the boundary, and the boundary is not the
104
+ * container it happens to be running in.
105
+ */
106
+ export function boundarySignal(boundary) {
107
+ const placement = boundary.placement;
108
+ const stable = placement === null
109
+ ? {}
110
+ : {
111
+ ...(placement.clusterId === null ? {} : { cluster_id: placement.clusterId }),
112
+ ...(placement.namespace === null ? {} : { namespace: placement.namespace }),
113
+ ...(placement.region === null ? {} : { region: placement.region }),
114
+ ...(placement.workloadId === null ? {} : { workload_id: placement.workloadId }),
115
+ };
116
+ return {
117
+ boundary_id: boundary.boundaryId,
118
+ agentsafe_version: boundary.agentsafeVersion,
119
+ protocol_version: BOUNDARY_PROTOCOL,
120
+ deployment_type: boundary.deploymentType,
121
+ ...(boundary.environment === null ? {} : { environment: boundary.environment }),
122
+ conformance_version: boundary.conformanceVersion,
123
+ ...(Object.keys(stable).length === 0 ? {} : { placement: stable }),
124
+ };
125
+ }
126
+ //# sourceMappingURL=BoundaryIdentity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BoundaryIdentity.js","sourceRoot":"","sources":["../../src/boundary/BoundaryIdentity.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  import type { CliProcess } from "./CliProcess.js";
2
2
  /** The commands this module owns; the executor's own are dispatched by the entry. */
3
- export declare const GATEWAY_COMMANDS: readonly ["init", "proxy", "gateway", "run", "intercept", "status", "doctor", "test", "config", "login", "logout", "version", "help"];
3
+ export declare const GATEWAY_COMMANDS: readonly ["init", "proxy", "gateway", "run", "intercept", "host", "status", "doctor", "test", "identity", "config", "login", "logout", "version", "help"];
4
4
  export type GatewayCommand = (typeof GATEWAY_COMMANDS)[number];
5
5
  export declare function isGatewayCommand(command: string | undefined): command is GatewayCommand;
6
6
  /** Runs one of the gateway commands; every one ends by calling `exit`. */
@@ -1 +1 @@
1
- {"version":3,"file":"Commands.d.ts","sourceRoot":"","sources":["../../src/cli/Commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWlD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,uIAcnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,IAAI,cAAc,CAEvF;AAED,0EAA0E;AAC1E,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,IAAI,CAAC,CAwCf"}
1
+ {"version":3,"file":"Commands.d.ts","sourceRoot":"","sources":["../../src/cli/Commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAalD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,2JAgBnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,IAAI,cAAc,CAEvF;AAED,0EAA0E;AAC1E,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,IAAI,CAAC,CA8Cf"}
@@ -1,8 +1,10 @@
1
1
  import { packageVersion } from "../Version.js";
2
2
  import { runConfig } from "./ConfigCommand.js";
3
3
  import { runDoctor } from "./Doctor.js";
4
+ import { runIdentity } from "./Identity.js";
4
5
  import { usage } from "./Help.js";
5
6
  import { runInit } from "./Init.js";
7
+ import { runHost } from "./Host.js";
6
8
  import { runIntercept } from "./Intercept.js";
7
9
  import { runLogin, runLogout } from "./Login.js";
8
10
  import { runProxy } from "./Proxy.js";
@@ -15,9 +17,11 @@ export const GATEWAY_COMMANDS = [
15
17
  "gateway",
16
18
  "run",
17
19
  "intercept",
20
+ "host",
18
21
  "status",
19
22
  "doctor",
20
23
  "test",
24
+ "identity",
21
25
  "config",
22
26
  "login",
23
27
  "logout",
@@ -41,12 +45,18 @@ export async function runGatewayCommand(command, argv, io) {
41
45
  case "intercept":
42
46
  await runIntercept(io, argv);
43
47
  return;
48
+ case "host":
49
+ await runHost(io, argv);
50
+ return;
44
51
  case "status":
45
52
  await runStatus(io, argv);
46
53
  return;
47
54
  case "doctor":
48
55
  await runDoctor(io, argv);
49
56
  return;
57
+ case "identity":
58
+ runIdentity(io, argv);
59
+ return;
50
60
  case "test":
51
61
  await runTest(io, argv);
52
62
  return;
@@ -1 +1 @@
1
- {"version":3,"file":"Commands.js","sourceRoot":"","sources":["../../src/cli/Commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;CACE,CAAC;AAIX,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC1D,OAAO,OAAO,KAAK,SAAS,IAAK,gBAAsC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5F,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB,EACvB,IAAuB,EACvB,EAAc;IAEd,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,KAAK,OAAO,CAAC;QACb,KAAK,SAAS,CAAC;QACf,KAAK,KAAK;YACR,MAAM,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,KAAK,WAAW;YACd,MAAM,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO;QACT,KAAK,MAAM;YACT,MAAM,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,KAAK,QAAQ;YACX,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,KAAK,OAAO;YACV,MAAM,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,KAAK,QAAQ;YACX,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,OAAO;QACT,KAAK,SAAS;YACZ,EAAE,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,IAAI,CAAC,CAAC;YACnC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACX,OAAO;QACT,KAAK,MAAM;YACT,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;YACnC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACX,OAAO;IACX,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"Commands.js","sourceRoot":"","sources":["../../src/cli/Commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,WAAW;IACX,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,UAAU;IACV,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;CACE,CAAC;AAIX,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC1D,OAAO,OAAO,KAAK,SAAS,IAAK,gBAAsC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5F,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB,EACvB,IAAuB,EACvB,EAAc;IAEd,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,KAAK,OAAO,CAAC;QACb,KAAK,SAAS,CAAC;QACf,KAAK,KAAK;YACR,MAAM,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,KAAK,WAAW;YACd,MAAM,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO;QACT,KAAK,MAAM;YACT,MAAM,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO;QACT,KAAK,UAAU;YACb,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACtB,OAAO;QACT,KAAK,MAAM;YACT,MAAM,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,KAAK,QAAQ;YACX,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,KAAK,OAAO;YACV,MAAM,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,KAAK,QAAQ;YACX,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,OAAO;QACT,KAAK,SAAS;YACZ,EAAE,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,IAAI,CAAC,CAAC;YACnC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACX,OAAO;QACT,KAAK,MAAM;YACT,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;YACnC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACX,OAAO;IACX,CAAC;AACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { CliProcess } from "./CliProcess.js";
2
+ export declare const EDGE_COMMANDS: readonly ["usage-report", "verify-usage-report", "usage-key", "replay-schema"];
3
+ export declare function runEdge(io: CliProcess, argv: readonly string[]): Promise<void>;
4
+ //# sourceMappingURL=Edge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Edge.d.ts","sourceRoot":"","sources":["../../src/cli/Edge.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,eAAO,MAAM,aAAa,gFAKhB,CAAC;AAoMX,wBAAsB,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BpF"}
@@ -0,0 +1,250 @@
1
+ /**
2
+ * `agentsafe edge <command>`: the edge evaluator's operator commands, all
3
+ * offline except `usage-report --send` and `usage-key --register`.
4
+ *
5
+ * usage-report Count a month's edge decisions from a collected log and sign the report
6
+ * verify-usage-report Check a report's signature and recount it from the log
7
+ * usage-key Print the usage-report key's kid and public JWK; `--register` registers it
8
+ * replay-schema Print the DDL for the shared Postgres replay store
9
+ *
10
+ * Exit 0 when the command did its job, 1 when a count or a check failed,
11
+ * 2 when it could not run: an option it does not know, or a file it needs
12
+ * that is not there.
13
+ */
14
+ import { PostgresReplayStore } from "@decionis/agent-safe-pipeline";
15
+ import { EVIDENCE_STREAM } from "../audit/HashChainedAuditSink.js";
16
+ import { countUsage, verifyUsage } from "../edge/UsageCount.js";
17
+ import { usagePeriod } from "../edge/UsagePeriod.js";
18
+ import { claimedUsage, readUsageReport, signUsageReport, usageReportClaims, usageSigningKey, } from "../edge/UsageReport.js";
19
+ import { registerUsageKey } from "../edge/UsageKeyRegistration.js";
20
+ import { UrlUsageDelivery } from "../edge/UsageMeter.js";
21
+ import { ArgumentError, optionValue, parseArguments } from "./Arguments.js";
22
+ export const EDGE_COMMANDS = [
23
+ "usage-report",
24
+ "verify-usage-report",
25
+ "usage-key",
26
+ "replay-schema",
27
+ ];
28
+ const SPECS = {
29
+ "usage-report": {
30
+ valued: ["period", "log", "head", "installation", "org", "key", "key-id", "out", "stream"],
31
+ flags: ["send"],
32
+ },
33
+ "verify-usage-report": { valued: ["log", "public-jwk", "key"], flags: [] },
34
+ "usage-key": { valued: ["key", "key-id", "installation"], flags: ["register"] },
35
+ "replay-schema": { valued: ["table"], flags: [] },
36
+ };
37
+ class UsageError extends Error {
38
+ }
39
+ function lines(text) {
40
+ return text.replace(/\n$/, "").split("\n");
41
+ }
42
+ /** A file the command cannot do without, or a usage error naming it. */
43
+ function required(io, path, what) {
44
+ if (path === undefined)
45
+ throw new UsageError(`${what.toUpperCase()}_REQUIRED`);
46
+ const text = io.files.read(path);
47
+ if (text === null)
48
+ throw new UsageError(`${what.toUpperCase()}_UNREADABLE`);
49
+ return text;
50
+ }
51
+ /** The usage-report key: `--key`, or the executor's own variable (or its `_FILE`). */
52
+ function signingKey(io, parsed) {
53
+ const file = optionValue(parsed, "key") ?? io.env["EXECUTOR_EDGE_USAGE_SIGNING_KEY_FILE"];
54
+ const pem = file === undefined ? io.env["EXECUTOR_EDGE_USAGE_SIGNING_KEY"] : required(io, file, "key");
55
+ if (pem === undefined)
56
+ throw new UsageError("KEY_REQUIRED");
57
+ try {
58
+ return usageSigningKey(pem, optionValue(parsed, "key-id") ?? io.env["EXECUTOR_EDGE_USAGE_KEY_ID"] ?? null);
59
+ }
60
+ catch {
61
+ throw new UsageError("KEY_INVALID");
62
+ }
63
+ }
64
+ /**
65
+ * The installation the report is for: `--installation`, the configured id,
66
+ * or the id the executor generated and kept beside its tally.
67
+ */
68
+ function installation(io, parsed) {
69
+ const named = optionValue(parsed, "installation") ?? io.env["EXECUTOR_EDGE_INSTALLATION_ID"];
70
+ if (named !== undefined)
71
+ return named;
72
+ const journal = io.env["EXECUTOR_JOURNAL_DIR"];
73
+ const state = journal === undefined ? null : io.files.read(`${journal}/edge/usage.json`);
74
+ try {
75
+ const id = JSON.parse(state ?? "null")
76
+ ?.installation_id;
77
+ if (typeof id === "string")
78
+ return id;
79
+ }
80
+ catch {
81
+ // An unreadable tally names no installation.
82
+ }
83
+ throw new UsageError("INSTALLATION_REQUIRED");
84
+ }
85
+ /** Where Decionis is and the key to call it with: `DECIONIS_API_URL`, `DECIONIS_API_KEY(_FILE)`. */
86
+ function decionis(io) {
87
+ const baseUrl = io.env["DECIONIS_API_URL"];
88
+ const apiKeyFile = io.env["DECIONIS_API_KEY_FILE"];
89
+ const apiKey = apiKeyFile === undefined ? io.env["DECIONIS_API_KEY"] : io.files.read(apiKeyFile)?.trim();
90
+ if (baseUrl === undefined || apiKey === undefined)
91
+ throw new UsageError("DECIONIS_REQUIRED");
92
+ return { baseUrl, apiKey };
93
+ }
94
+ async function usageReport(io, parsed) {
95
+ const period = usagePeriod(optionValue(parsed, "period") ?? "");
96
+ if (period === null)
97
+ throw new UsageError("PERIOD_REQUIRED");
98
+ const org = optionValue(parsed, "org") ?? io.env["EXECUTOR_EDGE_ORG_ID"];
99
+ if (org === undefined)
100
+ throw new UsageError("ORG_REQUIRED");
101
+ const log = required(io, optionValue(parsed, "log"), "log");
102
+ const key = signingKey(io, parsed);
103
+ const issuer = installation(io, parsed);
104
+ const stream = optionValue(parsed, "stream") ?? EVIDENCE_STREAM;
105
+ const head = optionValue(parsed, "head");
106
+ const count = countUsage(lines(log), {
107
+ stream,
108
+ period,
109
+ ...(head === undefined ? {} : { head }),
110
+ });
111
+ if (!count.ok) {
112
+ io.stderr(`${JSON.stringify({ event: "USAGE_COUNT_FAILED", findings: count.findings })}\n`);
113
+ return 1;
114
+ }
115
+ const claims = usageReportClaims({
116
+ installationId: issuer,
117
+ orgId: org,
118
+ period,
119
+ usage: count.usage,
120
+ stream,
121
+ now: Date.now(),
122
+ });
123
+ const report = await signUsageReport(claims, key);
124
+ const out = optionValue(parsed, "out");
125
+ if (out === undefined)
126
+ io.stdout(`${report}\n`);
127
+ else
128
+ io.files.write(out, `${report}\n`, 0o600);
129
+ io.stderr(`${JSON.stringify({ event: "USAGE_REPORT_SIGNED", kid: key.kid, period: claims.period, counts: claims.counts, delegated: claims.delegated, chain: claims.chain })}\n`);
130
+ if (parsed.options.get("send") !== true)
131
+ return 0;
132
+ const { baseUrl, apiKey } = decionis(io);
133
+ const code = await new UrlUsageDelivery({
134
+ baseUrl,
135
+ apiKey: () => apiKey,
136
+ fetch: io.fetch,
137
+ }).deliver(claims.period, issuer, report);
138
+ io.stderr(`${JSON.stringify({ event: "USAGE_REPORT_SENT", result: code })}\n`);
139
+ return code === "DELIVERED" ? 0 : 1;
140
+ }
141
+ async function verifyUsageReport(io, parsed) {
142
+ const token = required(io, parsed.positionals[0], "report").trim();
143
+ const log = required(io, optionValue(parsed, "log"), "log");
144
+ const jwkFile = optionValue(parsed, "public-jwk");
145
+ let jwk;
146
+ if (jwkFile === undefined) {
147
+ jwk = { ...signingKey(io, parsed).publicJwk };
148
+ }
149
+ else {
150
+ try {
151
+ jwk = JSON.parse(required(io, jwkFile, "public-jwk"));
152
+ }
153
+ catch (error) {
154
+ if (error instanceof UsageError)
155
+ throw error;
156
+ throw new UsageError("PUBLIC_JWK_INVALID");
157
+ }
158
+ }
159
+ const read = await readUsageReport(token, jwk);
160
+ if (!read.ok) {
161
+ io.stdout(`${JSON.stringify({ ok: false, code: read.code })}\n`);
162
+ return 1;
163
+ }
164
+ const period = usagePeriod(read.claims.period);
165
+ const recount = verifyUsage(lines(log), claimedUsage(read.claims), period);
166
+ io.stdout(`${JSON.stringify({ ok: recount.ok, kid: read.kid, iss: read.claims.iss, aud: read.claims.aud, period: read.claims.period, findings: recount.findings, recounted: recount.usage })}\n`);
167
+ return recount.ok ? 0 : 1;
168
+ }
169
+ async function usageKey(io, parsed) {
170
+ const key = signingKey(io, parsed);
171
+ const register = parsed.options.get("register") === true;
172
+ let issuer;
173
+ try {
174
+ issuer = installation(io, parsed);
175
+ }
176
+ catch (error) {
177
+ // Printing works before the installation has an id; registering does not.
178
+ if (register)
179
+ throw error;
180
+ issuer = "<installation id>";
181
+ }
182
+ const registration = {
183
+ kid: key.kid,
184
+ issuer,
185
+ algorithm: "EdDSA",
186
+ public_jwk: key.publicJwk,
187
+ purpose: "usage_report",
188
+ };
189
+ if (!register) {
190
+ // The body for POST /v1/execution/provider-keys; `issuer` is the installation id.
191
+ io.stdout(`${JSON.stringify({ kid: key.kid, public_jwk: key.publicJwk, registration })}\n`);
192
+ return 0;
193
+ }
194
+ const { baseUrl, apiKey } = decionis(io);
195
+ const outcome = await registerUsageKey({
196
+ baseUrl,
197
+ apiKey,
198
+ fetch: io.fetch,
199
+ key,
200
+ installationId: issuer,
201
+ });
202
+ io.stdout(`${JSON.stringify({ event: "USAGE_KEY_REGISTRATION", kid: key.kid, installation: issuer, ...outcome })}\n`);
203
+ return outcome.result === "REGISTERED" ? 0 : 1;
204
+ }
205
+ function replaySchema(io, parsed) {
206
+ let schema;
207
+ try {
208
+ schema = PostgresReplayStore.schema(optionValue(parsed, "table"));
209
+ }
210
+ catch {
211
+ throw new UsageError("TABLE_INVALID");
212
+ }
213
+ io.stdout(schema);
214
+ return 0;
215
+ }
216
+ export async function runEdge(io, argv) {
217
+ const command = argv[0];
218
+ if (command === undefined || !EDGE_COMMANDS.includes(command)) {
219
+ io.stderr(`${JSON.stringify({ event: "EDGE_COMMAND_REQUIRED", commands: EDGE_COMMANDS })}\n`);
220
+ io.exit(2);
221
+ return;
222
+ }
223
+ const name = command;
224
+ let exit;
225
+ try {
226
+ const parsed = parseArguments(argv.slice(1), SPECS[name]);
227
+ switch (name) {
228
+ case "usage-report":
229
+ exit = await usageReport(io, parsed);
230
+ break;
231
+ case "verify-usage-report":
232
+ exit = await verifyUsageReport(io, parsed);
233
+ break;
234
+ case "usage-key":
235
+ exit = await usageKey(io, parsed);
236
+ break;
237
+ case "replay-schema":
238
+ exit = replaySchema(io, parsed);
239
+ break;
240
+ }
241
+ }
242
+ catch (error) {
243
+ if (!(error instanceof UsageError || error instanceof ArgumentError))
244
+ throw error;
245
+ io.stderr(`${JSON.stringify({ event: "EDGE_USAGE_ERROR", code: error.message })}\n`);
246
+ exit = 2;
247
+ }
248
+ io.exit(exit);
249
+ }
250
+ //# sourceMappingURL=Edge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Edge.js","sourceRoot":"","sources":["../../src/cli/Edge.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"Help.d.ts","sourceRoot":"","sources":["../../src/cli/Help.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsC7C"}
1
+ {"version":3,"file":"Help.d.ts","sourceRoot":"","sources":["../../src/cli/Help.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA+C7C"}
package/dist/cli/Help.js CHANGED
@@ -10,8 +10,13 @@ export function usage(version) {
10
10
  " proxy Run the gateway (--upstream URL, --port N, --mode shadow|enforcement)",
11
11
  " run Run the gateway from agentsafe.yaml (same command, file first)",
12
12
  " intercept Run the transparent interceptor: observe every destination, govern the listed ones",
13
+ " host Serve many tenants' hosted gateways from a registry (--registry FILE, --port N)",
14
+ " connector Connect one fixed TCP resource outbound (--gateway URL, --route ID, --target IP:port, --credential-file FILE)",
15
+ " tunnel Open a TCP resource on 127.0.0.1 (--gateway URL, --route ID, --target IP:port, --credential-file FILE, --port N)",
16
+ " tcp-broker Run the internal hosted TCP rendezvous broker (operator only)",
13
17
  " status Ask a running gateway what it is doing",
14
18
  " doctor Check the binary, configuration, upstream, Decionis and credentials",
19
+ " identity Print which enforcement boundary this process is",
15
20
  " test Show what reaches a target without the boundary and what enforcement prevents",
16
21
  " config Print the effective configuration and where each setting came from",
17
22
  " login | logout Store or remove a Decionis key for this user (--provision mints a free workspace)",
@@ -25,6 +30,10 @@ export function usage(version) {
25
30
  "Trusted executor",
26
31
  " serve Run the proposal executor from the environment",
27
32
  " probe-containment Report whether a system of record answers the agent zone",
33
+ " edge usage-report Count a month's edge decisions from a log and sign the report (--send)",
34
+ " edge verify-usage-report <report> Check a usage report's signature and recount it",
35
+ " edge usage-key Print the usage-report key's kid and public JWK (--register registers it)",
36
+ " edge replay-schema Print the DDL for the shared Postgres replay store",
28
37
  "",
29
38
  " test [name=host:port]... also dials each real target: does it answer without the gateway?",
30
39
  " test --hosted the same requests with Decionis deciding, in shadow, against your workspace",
@@ -1 +1 @@
1
- {"version":3,"file":"Help.js","sourceRoot":"","sources":["../../src/cli/Help.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO;QACL,aAAa,OAAO,2DAA2D;QAC/E,EAAE;QACF,sCAAsC;QACtC,EAAE;QACF,SAAS;QACT,gEAAgE;QAChE,8FAA8F;QAC9F,uFAAuF;QACvF,2GAA2G;QAC3G,+DAA+D;QAC/D,4FAA4F;QAC5F,sGAAsG;QACtG,2FAA2F;QAC3F,0GAA0G;QAC1G,0CAA0C;QAC1C,EAAE;QACF,UAAU;QACV,2DAA2D;QAC3D,0DAA0D;QAC1D,oFAAoF;QACpF,EAAE;QACF,kBAAkB;QAClB,uEAAuE;QACvE,iFAAiF;QACjF,EAAE;QACF,8FAA8F;QAC9F,oGAAoG;QACpG,EAAE;QACF,0DAA0D;QAC1D,uEAAuE;QACvE,uEAAuE;QACvE,mDAAmD;QACnD,EAAE;QACF,oEAAoE;QACpE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
1
+ {"version":3,"file":"Help.js","sourceRoot":"","sources":["../../src/cli/Help.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO;QACL,aAAa,OAAO,2DAA2D;QAC/E,EAAE;QACF,sCAAsC;QACtC,EAAE;QACF,SAAS;QACT,gEAAgE;QAChE,8FAA8F;QAC9F,uFAAuF;QACvF,2GAA2G;QAC3G,wGAAwG;QACxG,sIAAsI;QACtI,yIAAyI;QACzI,sFAAsF;QACtF,+DAA+D;QAC/D,4FAA4F;QAC5F,yEAAyE;QACzE,sGAAsG;QACtG,2FAA2F;QAC3F,0GAA0G;QAC1G,0CAA0C;QAC1C,EAAE;QACF,UAAU;QACV,2DAA2D;QAC3D,0DAA0D;QAC1D,oFAAoF;QACpF,EAAE;QACF,kBAAkB;QAClB,uEAAuE;QACvE,iFAAiF;QACjF,+FAA+F;QAC/F,sFAAsF;QACtF,kGAAkG;QAClG,2EAA2E;QAC3E,EAAE;QACF,8FAA8F;QAC9F,oGAAoG;QACpG,EAAE;QACF,0DAA0D;QAC1D,uEAAuE;QACvE,uEAAuE;QACvE,mDAAmD;QACnD,EAAE;QACF,oEAAoE;QACpE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
@@ -0,0 +1,36 @@
1
+ import type { GatewayDependencies } from "../gateway/Gateway.js";
2
+ import type { CliProcess } from "./CliProcess.js";
3
+ export declare const HOST_ARGUMENTS: {
4
+ readonly valued: readonly ["registry", "port", "listen", "tls-cert", "tls-key", "redirect-listen", "apex-page"];
5
+ readonly flags: readonly ["require-upstream-proof"];
6
+ };
7
+ /** How often the registry is read for a change, when nothing says otherwise. */
8
+ export declare const REGISTRY_POLL_MS = 5000;
9
+ /** How often tenants that could not be built are tried again, with the registry unchanged. */
10
+ export declare const TENANT_RETRY_MS = 60000;
11
+ /**
12
+ * `agentsafe host`: many tenants' hosted gateways in one process, from the
13
+ * registry the operator mounts (`--registry` or `AGENTSAFE_TENANT_REGISTRY`).
14
+ * Every tenant is a hosted gateway at `{id}.{domain}`; a request is routed by
15
+ * its host alone, and a host no tenant has is refused with 421, except the
16
+ * platform's `healthz` and `readyz`; `readyz` is 503 until one load has
17
+ * served every tenant the registry names. The registry is read again on `SIGHUP`
18
+ * and whenever its text changes; `SIGTERM` and `SIGINT` stop the listener
19
+ * with a grace period, close every gateway and exit 0. Everything this
20
+ * process prints is JSON, one line each, and every tenant's line carries its
21
+ * id.
22
+ *
23
+ * With `--tls-cert` and `--tls-key` (or AGENTSAFE_TLS_CERT_FILE and
24
+ * AGENTSAFE_TLS_KEY_FILE) the listener terminates TLS itself, so a layer-4
25
+ * load balancer is the whole edge: the key is watched like any mounted
26
+ * secret, and a renewed certificate and key replace the context in place.
27
+ * `--redirect-listen` adds a plain-HTTP listener that only redirects to
28
+ * HTTPS, and `--apex-page` (an HTML file) is what the registry's domain
29
+ * itself answers at `/`. `--require-upstream-proof` makes every tenant's
30
+ * gateway forward nothing until its upstream's origin serves a token bound to
31
+ * the tenant, its workspace and that origin, and keep checking that it does
32
+ * (gateway/UpstreamProof.ts); `readyz` then also waits, at most 30 seconds,
33
+ * for each tenant's first look.
34
+ */
35
+ export declare function runHost(io: CliProcess, argv: readonly string[], dependencies?: Omit<GatewayDependencies, "env" | "io">, pollMs?: number, retryMs?: number, clock?: () => number): Promise<void>;
36
+ //# sourceMappingURL=Host.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Host.d.ts","sourceRoot":"","sources":["../../src/cli/Host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAYjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,8FAA8F;AAC9F,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,YAAY,GAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,IAAI,CAAM,EAC1D,MAAM,GAAE,MAAyB,EACjC,OAAO,GAAE,MAAwB,EACjC,KAAK,GAAE,MAAM,MAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAoNf"}