@decionis/agentsafe 0.1.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 (436) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +4 -0
  3. package/README.md +909 -0
  4. package/dist/Cli.d.ts +3 -0
  5. package/dist/Cli.d.ts.map +1 -0
  6. package/dist/Cli.js +150 -0
  7. package/dist/Cli.js.map +1 -0
  8. package/dist/Index.d.ts +104 -0
  9. package/dist/Index.d.ts.map +1 -0
  10. package/dist/Index.js +102 -0
  11. package/dist/Index.js.map +1 -0
  12. package/dist/Serve.d.ts +26 -0
  13. package/dist/Serve.d.ts.map +1 -0
  14. package/dist/Serve.js +143 -0
  15. package/dist/Serve.js.map +1 -0
  16. package/dist/TrustedExecutor.d.ts +66 -0
  17. package/dist/TrustedExecutor.d.ts.map +1 -0
  18. package/dist/TrustedExecutor.js +170 -0
  19. package/dist/TrustedExecutor.js.map +1 -0
  20. package/dist/Version.d.ts +6 -0
  21. package/dist/Version.d.ts.map +1 -0
  22. package/dist/Version.js +21 -0
  23. package/dist/Version.js.map +1 -0
  24. package/dist/adapters/AdapterActionHandler.d.ts +48 -0
  25. package/dist/adapters/AdapterActionHandler.d.ts.map +1 -0
  26. package/dist/adapters/AdapterActionHandler.js +148 -0
  27. package/dist/adapters/AdapterActionHandler.js.map +1 -0
  28. package/dist/adapters/EffectAdapter.d.ts +96 -0
  29. package/dist/adapters/EffectAdapter.d.ts.map +1 -0
  30. package/dist/adapters/EffectAdapter.js +16 -0
  31. package/dist/adapters/EffectAdapter.js.map +1 -0
  32. package/dist/adapters/EffectAwareGrantVerifier.d.ts +30 -0
  33. package/dist/adapters/EffectAwareGrantVerifier.d.ts.map +1 -0
  34. package/dist/adapters/EffectAwareGrantVerifier.js +38 -0
  35. package/dist/adapters/EffectAwareGrantVerifier.js.map +1 -0
  36. package/dist/adapters/EffectComparison.d.ts +20 -0
  37. package/dist/adapters/EffectComparison.d.ts.map +1 -0
  38. package/dist/adapters/EffectComparison.js +48 -0
  39. package/dist/adapters/EffectComparison.js.map +1 -0
  40. package/dist/adapters/EffectEvidenceBuilder.d.ts +60 -0
  41. package/dist/adapters/EffectEvidenceBuilder.d.ts.map +1 -0
  42. package/dist/adapters/EffectEvidenceBuilder.js +127 -0
  43. package/dist/adapters/EffectEvidenceBuilder.js.map +1 -0
  44. package/dist/adapters/EffectEvidenceRegister.d.ts +31 -0
  45. package/dist/adapters/EffectEvidenceRegister.d.ts.map +1 -0
  46. package/dist/adapters/EffectEvidenceRegister.js +21 -0
  47. package/dist/adapters/EffectEvidenceRegister.js.map +1 -0
  48. package/dist/adapters/JcsDigest.d.ts +43 -0
  49. package/dist/adapters/JcsDigest.d.ts.map +1 -0
  50. package/dist/adapters/JcsDigest.js +86 -0
  51. package/dist/adapters/JcsDigest.js.map +1 -0
  52. package/dist/adapters/banking/BankingAction.d.ts +146 -0
  53. package/dist/adapters/banking/BankingAction.d.ts.map +1 -0
  54. package/dist/adapters/banking/BankingAction.js +102 -0
  55. package/dist/adapters/banking/BankingAction.js.map +1 -0
  56. package/dist/adapters/banking/BankingAdapter.d.ts +60 -0
  57. package/dist/adapters/banking/BankingAdapter.d.ts.map +1 -0
  58. package/dist/adapters/banking/BankingAdapter.js +107 -0
  59. package/dist/adapters/banking/BankingAdapter.js.map +1 -0
  60. package/dist/adapters/banking/BankingHandlers.d.ts +24 -0
  61. package/dist/adapters/banking/BankingHandlers.d.ts.map +1 -0
  62. package/dist/adapters/banking/BankingHandlers.js +47 -0
  63. package/dist/adapters/banking/BankingHandlers.js.map +1 -0
  64. package/dist/adapters/banking/BankingIntentBinder.d.ts +47 -0
  65. package/dist/adapters/banking/BankingIntentBinder.d.ts.map +1 -0
  66. package/dist/adapters/banking/BankingIntentBinder.js +64 -0
  67. package/dist/adapters/banking/BankingIntentBinder.js.map +1 -0
  68. package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts +55 -0
  69. package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -0
  70. package/dist/adapters/banking/CoreBankingHttpAdapter.js +248 -0
  71. package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -0
  72. package/dist/adapters/banking/Currency.d.ts +10 -0
  73. package/dist/adapters/banking/Currency.d.ts.map +1 -0
  74. package/dist/adapters/banking/Currency.js +91 -0
  75. package/dist/adapters/banking/Currency.js.map +1 -0
  76. package/dist/adapters/banking/EffectProjections.d.ts +52 -0
  77. package/dist/adapters/banking/EffectProjections.d.ts.map +1 -0
  78. package/dist/adapters/banking/EffectProjections.js +140 -0
  79. package/dist/adapters/banking/EffectProjections.js.map +1 -0
  80. package/dist/adapters/banking/Iban.d.ts +18 -0
  81. package/dist/adapters/banking/Iban.d.ts.map +1 -0
  82. package/dist/adapters/banking/Iban.js +38 -0
  83. package/dist/adapters/banking/Iban.js.map +1 -0
  84. package/dist/adapters/banking/Money.d.ts +32 -0
  85. package/dist/adapters/banking/Money.d.ts.map +1 -0
  86. package/dist/adapters/banking/Money.js +81 -0
  87. package/dist/adapters/banking/Money.js.map +1 -0
  88. package/dist/adapters/banking/ReasonCodes.d.ts +19 -0
  89. package/dist/adapters/banking/ReasonCodes.d.ts.map +1 -0
  90. package/dist/adapters/banking/ReasonCodes.js +35 -0
  91. package/dist/adapters/banking/ReasonCodes.js.map +1 -0
  92. package/dist/audit/ChainJournal.d.ts +38 -0
  93. package/dist/audit/ChainJournal.d.ts.map +1 -0
  94. package/dist/audit/ChainJournal.js +97 -0
  95. package/dist/audit/ChainJournal.js.map +1 -0
  96. package/dist/audit/HashChain.d.ts +39 -0
  97. package/dist/audit/HashChain.d.ts.map +1 -0
  98. package/dist/audit/HashChain.js +63 -0
  99. package/dist/audit/HashChain.js.map +1 -0
  100. package/dist/audit/HashChainedAuditSink.d.ts +22 -0
  101. package/dist/audit/HashChainedAuditSink.d.ts.map +1 -0
  102. package/dist/audit/HashChainedAuditSink.js +26 -0
  103. package/dist/audit/HashChainedAuditSink.js.map +1 -0
  104. package/dist/audit/LineAuditSink.d.ts +19 -0
  105. package/dist/audit/LineAuditSink.d.ts.map +1 -0
  106. package/dist/audit/LineAuditSink.js +35 -0
  107. package/dist/audit/LineAuditSink.js.map +1 -0
  108. package/dist/cli/Arguments.d.ts +26 -0
  109. package/dist/cli/Arguments.d.ts.map +1 -0
  110. package/dist/cli/Arguments.js +66 -0
  111. package/dist/cli/Arguments.js.map +1 -0
  112. package/dist/cli/CliProcess.d.ts +29 -0
  113. package/dist/cli/CliProcess.d.ts.map +1 -0
  114. package/dist/cli/CliProcess.js +78 -0
  115. package/dist/cli/CliProcess.js.map +1 -0
  116. package/dist/cli/Commands.d.ts +8 -0
  117. package/dist/cli/Commands.d.ts.map +1 -0
  118. package/dist/cli/Commands.js +67 -0
  119. package/dist/cli/Commands.js.map +1 -0
  120. package/dist/cli/ConfigCommand.d.ts +7 -0
  121. package/dist/cli/ConfigCommand.d.ts.map +1 -0
  122. package/dist/cli/ConfigCommand.js +77 -0
  123. package/dist/cli/ConfigCommand.js.map +1 -0
  124. package/dist/cli/ConfigFile.d.ts +21 -0
  125. package/dist/cli/ConfigFile.d.ts.map +1 -0
  126. package/dist/cli/ConfigFile.js +57 -0
  127. package/dist/cli/ConfigFile.js.map +1 -0
  128. package/dist/cli/Credentials.d.ts +15 -0
  129. package/dist/cli/Credentials.d.ts.map +1 -0
  130. package/dist/cli/Credentials.js +51 -0
  131. package/dist/cli/Credentials.js.map +1 -0
  132. package/dist/cli/Doctor.d.ts +25 -0
  133. package/dist/cli/Doctor.d.ts.map +1 -0
  134. package/dist/cli/Doctor.js +211 -0
  135. package/dist/cli/Doctor.js.map +1 -0
  136. package/dist/cli/Help.d.ts +3 -0
  137. package/dist/cli/Help.d.ts.map +1 -0
  138. package/dist/cli/Help.js +38 -0
  139. package/dist/cli/Help.js.map +1 -0
  140. package/dist/cli/Init.d.ts +32 -0
  141. package/dist/cli/Init.d.ts.map +1 -0
  142. package/dist/cli/Init.js +163 -0
  143. package/dist/cli/Init.js.map +1 -0
  144. package/dist/cli/Login.d.ts +16 -0
  145. package/dist/cli/Login.d.ts.map +1 -0
  146. package/dist/cli/Login.js +74 -0
  147. package/dist/cli/Login.js.map +1 -0
  148. package/dist/cli/Proxy.d.ts +41 -0
  149. package/dist/cli/Proxy.d.ts.map +1 -0
  150. package/dist/cli/Proxy.js +161 -0
  151. package/dist/cli/Proxy.js.map +1 -0
  152. package/dist/cli/Status.d.ts +7 -0
  153. package/dist/cli/Status.d.ts.map +1 -0
  154. package/dist/cli/Status.js +64 -0
  155. package/dist/cli/Status.js.map +1 -0
  156. package/dist/cli/TestCommand.d.ts +36 -0
  157. package/dist/cli/TestCommand.d.ts.map +1 -0
  158. package/dist/cli/TestCommand.js +173 -0
  159. package/dist/cli/TestCommand.js.map +1 -0
  160. package/dist/config/ConfigKeys.d.ts +10 -0
  161. package/dist/config/ConfigKeys.d.ts.map +1 -0
  162. package/dist/config/ConfigKeys.js +105 -0
  163. package/dist/config/ConfigKeys.js.map +1 -0
  164. package/dist/config/ExecutorConfig.d.ts +254 -0
  165. package/dist/config/ExecutorConfig.d.ts.map +1 -0
  166. package/dist/config/ExecutorConfig.js +637 -0
  167. package/dist/config/ExecutorConfig.js.map +1 -0
  168. package/dist/containment/ContainmentProbe.d.ts +87 -0
  169. package/dist/containment/ContainmentProbe.d.ts.map +1 -0
  170. package/dist/containment/ContainmentProbe.js +103 -0
  171. package/dist/containment/ContainmentProbe.js.map +1 -0
  172. package/dist/credential/CredentialError.d.ts +6 -0
  173. package/dist/credential/CredentialError.d.ts.map +1 -0
  174. package/dist/credential/CredentialError.js +10 -0
  175. package/dist/credential/CredentialError.js.map +1 -0
  176. package/dist/credential/DownstreamCredential.d.ts +38 -0
  177. package/dist/credential/DownstreamCredential.d.ts.map +1 -0
  178. package/dist/credential/DownstreamCredential.js +2 -0
  179. package/dist/credential/DownstreamCredential.js.map +1 -0
  180. package/dist/credential/GrantOf.d.ts +10 -0
  181. package/dist/credential/GrantOf.d.ts.map +1 -0
  182. package/dist/credential/GrantOf.js +16 -0
  183. package/dist/credential/GrantOf.js.map +1 -0
  184. package/dist/credential/PrivateKeyJwtCredential.d.ts +43 -0
  185. package/dist/credential/PrivateKeyJwtCredential.d.ts.map +1 -0
  186. package/dist/credential/PrivateKeyJwtCredential.js +126 -0
  187. package/dist/credential/PrivateKeyJwtCredential.js.map +1 -0
  188. package/dist/credential/SignedRequestCredential.d.ts +112 -0
  189. package/dist/credential/SignedRequestCredential.d.ts.map +1 -0
  190. package/dist/credential/SignedRequestCredential.js +255 -0
  191. package/dist/credential/SignedRequestCredential.js.map +1 -0
  192. package/dist/credential/StaticHeaderCredential.d.ts +16 -0
  193. package/dist/credential/StaticHeaderCredential.d.ts.map +1 -0
  194. package/dist/credential/StaticHeaderCredential.js +21 -0
  195. package/dist/credential/StaticHeaderCredential.js.map +1 -0
  196. package/dist/egress/EgressError.d.ts +13 -0
  197. package/dist/egress/EgressError.d.ts.map +1 -0
  198. package/dist/egress/EgressError.js +16 -0
  199. package/dist/egress/EgressError.js.map +1 -0
  200. package/dist/egress/EgressPolicy.d.ts +55 -0
  201. package/dist/egress/EgressPolicy.d.ts.map +1 -0
  202. package/dist/egress/EgressPolicy.js +137 -0
  203. package/dist/egress/EgressPolicy.js.map +1 -0
  204. package/dist/egress/GlobalFetchLock.d.ts +16 -0
  205. package/dist/egress/GlobalFetchLock.d.ts.map +1 -0
  206. package/dist/egress/GlobalFetchLock.js +34 -0
  207. package/dist/egress/GlobalFetchLock.js.map +1 -0
  208. package/dist/egress/GuardedFetch.d.ts +56 -0
  209. package/dist/egress/GuardedFetch.d.ts.map +1 -0
  210. package/dist/egress/GuardedFetch.js +300 -0
  211. package/dist/egress/GuardedFetch.js.map +1 -0
  212. package/dist/egress/TcpProbe.d.ts +35 -0
  213. package/dist/egress/TcpProbe.d.ts.map +1 -0
  214. package/dist/egress/TcpProbe.js +45 -0
  215. package/dist/egress/TcpProbe.js.map +1 -0
  216. package/dist/gateway/Activation.d.ts +39 -0
  217. package/dist/gateway/Activation.d.ts.map +1 -0
  218. package/dist/gateway/Activation.js +61 -0
  219. package/dist/gateway/Activation.js.map +1 -0
  220. package/dist/gateway/BoundaryTest.d.ts +92 -0
  221. package/dist/gateway/BoundaryTest.d.ts.map +1 -0
  222. package/dist/gateway/BoundaryTest.js +349 -0
  223. package/dist/gateway/BoundaryTest.js.map +1 -0
  224. package/dist/gateway/DemoAuthority.d.ts +41 -0
  225. package/dist/gateway/DemoAuthority.d.ts.map +1 -0
  226. package/dist/gateway/DemoAuthority.js +66 -0
  227. package/dist/gateway/DemoAuthority.js.map +1 -0
  228. package/dist/gateway/ForwardHandler.d.ts +56 -0
  229. package/dist/gateway/ForwardHandler.d.ts.map +1 -0
  230. package/dist/gateway/ForwardHandler.js +111 -0
  231. package/dist/gateway/ForwardHandler.js.map +1 -0
  232. package/dist/gateway/Gateway.d.ts +142 -0
  233. package/dist/gateway/Gateway.d.ts.map +1 -0
  234. package/dist/gateway/Gateway.js +819 -0
  235. package/dist/gateway/Gateway.js.map +1 -0
  236. package/dist/gateway/GatewayConfig.d.ts +237 -0
  237. package/dist/gateway/GatewayConfig.d.ts.map +1 -0
  238. package/dist/gateway/GatewayConfig.js +706 -0
  239. package/dist/gateway/GatewayConfig.js.map +1 -0
  240. package/dist/gateway/GatewayMetrics.d.ts +26 -0
  241. package/dist/gateway/GatewayMetrics.d.ts.map +1 -0
  242. package/dist/gateway/GatewayMetrics.js +28 -0
  243. package/dist/gateway/GatewayMetrics.js.map +1 -0
  244. package/dist/gateway/GatewayReport.d.ts +74 -0
  245. package/dist/gateway/GatewayReport.d.ts.map +1 -0
  246. package/dist/gateway/GatewayReport.js +109 -0
  247. package/dist/gateway/GatewayReport.js.map +1 -0
  248. package/dist/gateway/InterceptedRequest.d.ts +53 -0
  249. package/dist/gateway/InterceptedRequest.d.ts.map +1 -0
  250. package/dist/gateway/InterceptedRequest.js +80 -0
  251. package/dist/gateway/InterceptedRequest.js.map +1 -0
  252. package/dist/gateway/RouteTable.d.ts +28 -0
  253. package/dist/gateway/RouteTable.d.ts.map +1 -0
  254. package/dist/gateway/RouteTable.js +72 -0
  255. package/dist/gateway/RouteTable.js.map +1 -0
  256. package/dist/gateway/Upstream.d.ts +46 -0
  257. package/dist/gateway/Upstream.d.ts.map +1 -0
  258. package/dist/gateway/Upstream.js +158 -0
  259. package/dist/gateway/Upstream.js.map +1 -0
  260. package/dist/handlers/ForwardRequestHandler.d.ts +26 -0
  261. package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -0
  262. package/dist/handlers/ForwardRequestHandler.js +98 -0
  263. package/dist/handlers/ForwardRequestHandler.js.map +1 -0
  264. package/dist/handlers/HandlerRegistration.d.ts +37 -0
  265. package/dist/handlers/HandlerRegistration.d.ts.map +1 -0
  266. package/dist/handlers/HandlerRegistration.js +2 -0
  267. package/dist/handlers/HandlerRegistration.js.map +1 -0
  268. package/dist/handlers/JournaledActionHandler.d.ts +31 -0
  269. package/dist/handlers/JournaledActionHandler.d.ts.map +1 -0
  270. package/dist/handlers/JournaledActionHandler.js +63 -0
  271. package/dist/handlers/JournaledActionHandler.js.map +1 -0
  272. package/dist/http/ExecutorHttpServer.d.ts +33 -0
  273. package/dist/http/ExecutorHttpServer.d.ts.map +1 -0
  274. package/dist/http/ExecutorHttpServer.js +176 -0
  275. package/dist/http/ExecutorHttpServer.js.map +1 -0
  276. package/dist/http/GatewayHttpServer.d.ts +42 -0
  277. package/dist/http/GatewayHttpServer.d.ts.map +1 -0
  278. package/dist/http/GatewayHttpServer.js +195 -0
  279. package/dist/http/GatewayHttpServer.js.map +1 -0
  280. package/dist/http/RecordingTarget.d.ts +18 -0
  281. package/dist/http/RecordingTarget.d.ts.map +1 -0
  282. package/dist/http/RecordingTarget.js +71 -0
  283. package/dist/http/RecordingTarget.js.map +1 -0
  284. package/dist/http/RequestContext.d.ts +17 -0
  285. package/dist/http/RequestContext.d.ts.map +1 -0
  286. package/dist/http/RequestContext.js +19 -0
  287. package/dist/http/RequestContext.js.map +1 -0
  288. package/dist/http/Routes.d.ts +93 -0
  289. package/dist/http/Routes.d.ts.map +1 -0
  290. package/dist/http/Routes.js +46 -0
  291. package/dist/http/Routes.js.map +1 -0
  292. package/dist/http/TlsListener.d.ts +38 -0
  293. package/dist/http/TlsListener.d.ts.map +1 -0
  294. package/dist/http/TlsListener.js +52 -0
  295. package/dist/http/TlsListener.js.map +1 -0
  296. package/dist/identity/Authenticator.d.ts +58 -0
  297. package/dist/identity/Authenticator.d.ts.map +1 -0
  298. package/dist/identity/Authenticator.js +170 -0
  299. package/dist/identity/Authenticator.js.map +1 -0
  300. package/dist/identity/PeerIdentity.d.ts +24 -0
  301. package/dist/identity/PeerIdentity.d.ts.map +1 -0
  302. package/dist/identity/PeerIdentity.js +29 -0
  303. package/dist/identity/PeerIdentity.js.map +1 -0
  304. package/dist/identity/PrincipalRegistry.d.ts +102 -0
  305. package/dist/identity/PrincipalRegistry.d.ts.map +1 -0
  306. package/dist/identity/PrincipalRegistry.js +191 -0
  307. package/dist/identity/PrincipalRegistry.js.map +1 -0
  308. package/dist/identity/PrincipalsFile.d.ts +152 -0
  309. package/dist/identity/PrincipalsFile.d.ts.map +1 -0
  310. package/dist/identity/PrincipalsFile.js +125 -0
  311. package/dist/identity/PrincipalsFile.js.map +1 -0
  312. package/dist/identity/RateLimiter.d.ts +43 -0
  313. package/dist/identity/RateLimiter.d.ts.map +1 -0
  314. package/dist/identity/RateLimiter.js +84 -0
  315. package/dist/identity/RateLimiter.js.map +1 -0
  316. package/dist/identity/SeparationOfDuties.d.ts +11 -0
  317. package/dist/identity/SeparationOfDuties.d.ts.map +1 -0
  318. package/dist/identity/SeparationOfDuties.js +25 -0
  319. package/dist/identity/SeparationOfDuties.js.map +1 -0
  320. package/dist/identity/WorkloadJwtVerifier.d.ts +57 -0
  321. package/dist/identity/WorkloadJwtVerifier.d.ts.map +1 -0
  322. package/dist/identity/WorkloadJwtVerifier.js +145 -0
  323. package/dist/identity/WorkloadJwtVerifier.js.map +1 -0
  324. package/dist/incident/EvidenceExport.d.ts +128 -0
  325. package/dist/incident/EvidenceExport.d.ts.map +1 -0
  326. package/dist/incident/EvidenceExport.js +187 -0
  327. package/dist/incident/EvidenceExport.js.map +1 -0
  328. package/dist/incident/FileProbe.d.ts +22 -0
  329. package/dist/incident/FileProbe.d.ts.map +1 -0
  330. package/dist/incident/FileProbe.js +31 -0
  331. package/dist/incident/FileProbe.js.map +1 -0
  332. package/dist/incident/HaltSwitch.d.ts +95 -0
  333. package/dist/incident/HaltSwitch.d.ts.map +1 -0
  334. package/dist/incident/HaltSwitch.js +171 -0
  335. package/dist/incident/HaltSwitch.js.map +1 -0
  336. package/dist/incident/Metrics.d.ts +71 -0
  337. package/dist/incident/Metrics.d.ts.map +1 -0
  338. package/dist/incident/Metrics.js +146 -0
  339. package/dist/incident/Metrics.js.map +1 -0
  340. package/dist/incident/SecurityEvents.d.ts +182 -0
  341. package/dist/incident/SecurityEvents.d.ts.map +1 -0
  342. package/dist/incident/SecurityEvents.js +167 -0
  343. package/dist/incident/SecurityEvents.js.map +1 -0
  344. package/dist/journal/ExecutionJournal.d.ts +96 -0
  345. package/dist/journal/ExecutionJournal.d.ts.map +1 -0
  346. package/dist/journal/ExecutionJournal.js +100 -0
  347. package/dist/journal/ExecutionJournal.js.map +1 -0
  348. package/dist/journal/FileExecutionJournal.d.ts +38 -0
  349. package/dist/journal/FileExecutionJournal.d.ts.map +1 -0
  350. package/dist/journal/FileExecutionJournal.js +137 -0
  351. package/dist/journal/FileExecutionJournal.js.map +1 -0
  352. package/dist/journal/InMemoryExecutionJournal.d.ts +23 -0
  353. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -0
  354. package/dist/journal/InMemoryExecutionJournal.js +47 -0
  355. package/dist/journal/InMemoryExecutionJournal.js.map +1 -0
  356. package/dist/journal/StartupReconciler.d.ts +47 -0
  357. package/dist/journal/StartupReconciler.d.ts.map +1 -0
  358. package/dist/journal/StartupReconciler.js +89 -0
  359. package/dist/journal/StartupReconciler.js.map +1 -0
  360. package/dist/limits/HardLimits.d.ts +63 -0
  361. package/dist/limits/HardLimits.d.ts.map +1 -0
  362. package/dist/limits/HardLimits.js +120 -0
  363. package/dist/limits/HardLimits.js.map +1 -0
  364. package/dist/logging/LineEmitter.d.ts +26 -0
  365. package/dist/logging/LineEmitter.d.ts.map +1 -0
  366. package/dist/logging/LineEmitter.js +36 -0
  367. package/dist/logging/LineEmitter.js.map +1 -0
  368. package/dist/posture/HostPosture.d.ts +60 -0
  369. package/dist/posture/HostPosture.d.ts.map +1 -0
  370. package/dist/posture/HostPosture.js +104 -0
  371. package/dist/posture/HostPosture.js.map +1 -0
  372. package/dist/posture/PostureChecks.d.ts +52 -0
  373. package/dist/posture/PostureChecks.d.ts.map +1 -0
  374. package/dist/posture/PostureChecks.js +172 -0
  375. package/dist/posture/PostureChecks.js.map +1 -0
  376. package/dist/secrets/CompositeSecretStore.d.ts +37 -0
  377. package/dist/secrets/CompositeSecretStore.d.ts.map +1 -0
  378. package/dist/secrets/CompositeSecretStore.js +99 -0
  379. package/dist/secrets/CompositeSecretStore.js.map +1 -0
  380. package/dist/secrets/EnvSecretStore.d.ts +18 -0
  381. package/dist/secrets/EnvSecretStore.d.ts.map +1 -0
  382. package/dist/secrets/EnvSecretStore.js +46 -0
  383. package/dist/secrets/EnvSecretStore.js.map +1 -0
  384. package/dist/secrets/FileSecretStore.d.ts +60 -0
  385. package/dist/secrets/FileSecretStore.d.ts.map +1 -0
  386. package/dist/secrets/FileSecretStore.js +180 -0
  387. package/dist/secrets/FileSecretStore.js.map +1 -0
  388. package/dist/secrets/Redactor.d.ts +32 -0
  389. package/dist/secrets/Redactor.d.ts.map +1 -0
  390. package/dist/secrets/Redactor.js +108 -0
  391. package/dist/secrets/Redactor.js.map +1 -0
  392. package/dist/secrets/SecretHandle.d.ts +34 -0
  393. package/dist/secrets/SecretHandle.d.ts.map +1 -0
  394. package/dist/secrets/SecretHandle.js +71 -0
  395. package/dist/secrets/SecretHandle.js.map +1 -0
  396. package/dist/secrets/SecretStore.d.ts +37 -0
  397. package/dist/secrets/SecretStore.d.ts.map +1 -0
  398. package/dist/secrets/SecretStore.js +12 -0
  399. package/dist/secrets/SecretStore.js.map +1 -0
  400. package/dist/service/AuthorityClients.d.ts +50 -0
  401. package/dist/service/AuthorityClients.d.ts.map +1 -0
  402. package/dist/service/AuthorityClients.js +83 -0
  403. package/dist/service/AuthorityClients.js.map +1 -0
  404. package/dist/service/EscalationResolver.d.ts +97 -0
  405. package/dist/service/EscalationResolver.d.ts.map +1 -0
  406. package/dist/service/EscalationResolver.js +196 -0
  407. package/dist/service/EscalationResolver.js.map +1 -0
  408. package/dist/service/Requests.d.ts +99 -0
  409. package/dist/service/Requests.d.ts.map +1 -0
  410. package/dist/service/Requests.js +42 -0
  411. package/dist/service/Requests.js.map +1 -0
  412. package/dist/service/ServiceError.d.ts +20 -0
  413. package/dist/service/ServiceError.d.ts.map +1 -0
  414. package/dist/service/ServiceError.js +25 -0
  415. package/dist/service/ServiceError.js.map +1 -0
  416. package/dist/service/TrustedExecutorService.d.ts +221 -0
  417. package/dist/service/TrustedExecutorService.d.ts.map +1 -0
  418. package/dist/service/TrustedExecutorService.js +1066 -0
  419. package/dist/service/TrustedExecutorService.js.map +1 -0
  420. package/dist/time/ClockSkewGuard.d.ts +25 -0
  421. package/dist/time/ClockSkewGuard.d.ts.map +1 -0
  422. package/dist/time/ClockSkewGuard.js +35 -0
  423. package/dist/time/ClockSkewGuard.js.map +1 -0
  424. package/dist/time/MonotonicClock.d.ts +35 -0
  425. package/dist/time/MonotonicClock.d.ts.map +1 -0
  426. package/dist/time/MonotonicClock.js +52 -0
  427. package/dist/time/MonotonicClock.js.map +1 -0
  428. package/dist/verify/VerifyAuditChain.d.ts +36 -0
  429. package/dist/verify/VerifyAuditChain.d.ts.map +1 -0
  430. package/dist/verify/VerifyAuditChain.js +109 -0
  431. package/dist/verify/VerifyAuditChain.js.map +1 -0
  432. package/dist/verify/VerifyEvidenceBundle.d.ts +50 -0
  433. package/dist/verify/VerifyEvidenceBundle.d.ts.map +1 -0
  434. package/dist/verify/VerifyEvidenceBundle.js +157 -0
  435. package/dist/verify/VerifyEvidenceBundle.js.map +1 -0
  436. package/package.json +80 -0
@@ -0,0 +1,176 @@
1
+ import { once } from "node:events";
2
+ import { createServer, } from "node:http";
3
+ import { AuthError, } from "../identity/Authenticator.js";
4
+ import { peerIdentity } from "../identity/PeerIdentity.js";
5
+ import { ServiceError } from "../service/ServiceError.js";
6
+ import { RequestContext } from "./RequestContext.js";
7
+ import { MAX_BODY_BYTES, METRICS_CONTENT_TYPE, RESPONSE_HEADERS, ROUTES, } from "./Routes.js";
8
+ const REQUEST_TIMEOUT_MS = 15_000;
9
+ const HEADERS_TIMEOUT_MS = 5_000;
10
+ const KEEP_ALIVE_TIMEOUT_MS = 5_000;
11
+ class GuardError extends Error {
12
+ status;
13
+ code;
14
+ constructor(status, code) {
15
+ super(code);
16
+ this.status = status;
17
+ this.code = code;
18
+ // Stryker disable next-line StringLiteral: the name is diagnostic and never reaches a response.
19
+ this.name = "GuardError";
20
+ }
21
+ }
22
+ /**
23
+ * The process's one listener. Every route that is not public goes through
24
+ * the authenticator, which decides who the caller is and whether the route
25
+ * is theirs; the body is bounded before it is read; a failure is a status
26
+ * and a code, never a message, a stack, or anything from the request.
27
+ * Every authenticated request runs inside a request scope, so the evidence
28
+ * lines it causes name the principal.
29
+ */
30
+ export class ExecutorHttpServer {
31
+ service;
32
+ authenticator;
33
+ server;
34
+ tls;
35
+ constructor(service, authenticator, options = {}) {
36
+ this.service = service;
37
+ this.authenticator = authenticator;
38
+ this.tls = options.tls ?? null;
39
+ const handler = (request, response) => {
40
+ void this.handle(request, response);
41
+ };
42
+ this.server = this.tls === null ? createServer(handler) : this.tls.createServer(handler);
43
+ this.server.requestTimeout = REQUEST_TIMEOUT_MS;
44
+ this.server.headersTimeout = HEADERS_TIMEOUT_MS;
45
+ this.server.keepAliveTimeout = KEEP_ALIVE_TIMEOUT_MS;
46
+ }
47
+ async listen(port, address) {
48
+ this.server.listen(port, address);
49
+ // Resolves on "listening" and rejects on an "error" emitted before it.
50
+ await once(this.server, "listening");
51
+ return this.server.address();
52
+ }
53
+ async close() {
54
+ this.server.closeAllConnections();
55
+ await new Promise((resolve) => this.server.close(() => resolve()));
56
+ }
57
+ /** Replaces the TLS context from the current material; connections already open keep theirs. */
58
+ rotateTls() {
59
+ if (this.tls === null)
60
+ return;
61
+ this.tls.rotate(this.server);
62
+ }
63
+ async handle(request, response) {
64
+ try {
65
+ // Stryker disable next-line all: Node sets `url` on every request it hands out; the fallback satisfies the type.
66
+ const pathname = new URL(request.url ?? "/", "http://executor.invalid").pathname;
67
+ const route = ROUTES.find((candidate) => candidate.path === pathname);
68
+ if (route === undefined)
69
+ throw new GuardError(404, "NOT_FOUND");
70
+ if (route.method !== request.method)
71
+ throw new GuardError(405, "METHOD_NOT_ALLOWED");
72
+ // Liveness stays 200 while halted: a halt is a decision to stop taking
73
+ // work, not a reason for the orchestrator to restart the process and
74
+ // lose what it knows.
75
+ if (route.path === "/health")
76
+ return ExecutorHttpServer.reply(response, 200, { status: "ok" });
77
+ if (route.path === "/ready") {
78
+ const readiness = this.service.readiness();
79
+ return ExecutorHttpServer.reply(response, readiness.ready ? 200 : 503, readiness.body);
80
+ }
81
+ const caller = await this.authenticator.authenticate({
82
+ authorization: request.headers.authorization,
83
+ peer: peerIdentity(request.socket),
84
+ route,
85
+ });
86
+ await RequestContext.run({ principal: caller.principal.id }, () => this.dispatch(route.path, request, response, caller));
87
+ }
88
+ catch (error) {
89
+ if (error instanceof GuardError ||
90
+ error instanceof ServiceError ||
91
+ error instanceof AuthError) {
92
+ ExecutorHttpServer.reply(response, error.status, error instanceof ServiceError && error.body !== undefined
93
+ ? error.body
94
+ : { code: error.code }, error instanceof ServiceError && error.retryAfterSeconds !== undefined
95
+ ? { "retry-after": String(error.retryAfterSeconds) }
96
+ : {});
97
+ }
98
+ else {
99
+ ExecutorHttpServer.reply(response, 500, { code: "INTERNAL_ERROR" });
100
+ }
101
+ }
102
+ }
103
+ async dispatch(path, request, response, caller) {
104
+ switch (path) {
105
+ case "/v1/actions":
106
+ return ExecutorHttpServer.reply(response, 200, await this.service.propose(await ExecutorHttpServer.readJson(request), caller.principal));
107
+ case "/v1/reconciliations":
108
+ return ExecutorHttpServer.reply(response, 200, await this.service.reconcile(await ExecutorHttpServer.readJson(request), caller.principal));
109
+ case "/v1/escalations":
110
+ return ExecutorHttpServer.reply(response, 200, await this.service.resume(await ExecutorHttpServer.readJson(request), caller.principal));
111
+ case "/v1/control/status":
112
+ return ExecutorHttpServer.reply(response, 200, this.service.status(caller.principal));
113
+ case "/v1/control/halt":
114
+ return ExecutorHttpServer.reply(response, 200, this.service.halt(await ExecutorHttpServer.readJson(request), caller.principal));
115
+ case "/v1/control/resume":
116
+ return ExecutorHttpServer.reply(response, 200, this.service.resumeWork(await ExecutorHttpServer.readJson(request), caller.principal));
117
+ case "/v1/control/open-attempts":
118
+ return ExecutorHttpServer.reply(response, 200, this.service.openAttempts(caller.principal));
119
+ case "/v1/control/evidence-export": {
120
+ const bundle = await this.service.exportEvidence(await ExecutorHttpServer.readJson(request), caller.principal);
121
+ // The bundle's own manifest and where it was written, so an operator
122
+ // can fetch it; the files themselves stay on the volume.
123
+ return ExecutorHttpServer.reply(response, 200, {
124
+ directory: bundle.directory,
125
+ signed: bundle.signature !== null,
126
+ manifest: bundle.manifest,
127
+ });
128
+ }
129
+ case "/v1/control/secrets/reload":
130
+ return ExecutorHttpServer.reply(response, 200, await this.service.reloadSecrets(caller.principal));
131
+ case "/metrics":
132
+ return ExecutorHttpServer.replyText(response, this.service.metricsText(caller.principal));
133
+ }
134
+ }
135
+ static async readJson(request) {
136
+ // Absent or unparseable is NaN, which is not finite and so not refused here;
137
+ // the streamed count below still bounds what is read.
138
+ const declared = Number(request.headers["content-length"]);
139
+ if (Number.isFinite(declared) && declared > MAX_BODY_BYTES) {
140
+ throw new GuardError(413, "BODY_TOO_LARGE");
141
+ }
142
+ const chunks = [];
143
+ let size = 0;
144
+ for await (const chunk of request) {
145
+ const buffer = chunk;
146
+ size += buffer.length;
147
+ if (size > MAX_BODY_BYTES)
148
+ throw new GuardError(413, "BODY_TOO_LARGE");
149
+ chunks.push(buffer);
150
+ }
151
+ const text = Buffer.concat(chunks).toString("utf8");
152
+ if (text.trim() === "")
153
+ throw new GuardError(400, "BODY_REQUIRED");
154
+ try {
155
+ return JSON.parse(text);
156
+ }
157
+ catch {
158
+ throw new GuardError(400, "BODY_NOT_JSON");
159
+ }
160
+ }
161
+ static reply(response, status, body, headers = {}) {
162
+ // Stryker disable next-line ConditionalExpression: a reply is written once per request; the guard is defensive.
163
+ if (response.headersSent)
164
+ return;
165
+ response.writeHead(status, { ...RESPONSE_HEADERS, ...headers });
166
+ response.end(JSON.stringify(body));
167
+ }
168
+ static replyText(response, text) {
169
+ // Stryker disable next-line ConditionalExpression: a reply is written once per request; the guard is defensive.
170
+ if (response.headersSent)
171
+ return;
172
+ response.writeHead(200, { ...RESPONSE_HEADERS, "content-type": METRICS_CONTENT_TYPE });
173
+ response.end(text);
174
+ }
175
+ }
176
+ //# sourceMappingURL=ExecutorHttpServer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExecutorHttpServer.js","sourceRoot":"","sources":["../../src/http/ExecutorHttpServer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ import type { AddressInfo } from "node:net";
2
+ import { type Gateway } from "../gateway/Gateway.js";
3
+ export interface GatewayHttpServerOptions {
4
+ /** A bearer token the metrics route requires; open when null, which is the local default. */
5
+ readonly metricsToken?: string | null;
6
+ }
7
+ /**
8
+ * Which gateway answers a request, by the host it was addressed to. One
9
+ * listener can front many gateways this way, each with its own upstream,
10
+ * key, tenant and mode: the hosted shape, where every governed endpoint is
11
+ * a host name and none is a separate implementation. `null` refuses the
12
+ * host with 421.
13
+ */
14
+ export type GatewaySelector = (hostname: string | null) => Gateway | null;
15
+ /**
16
+ * The interception listener. Every request is either the gateway's own
17
+ * (under `/_agentsafe`), passed through unchanged, or governed: the body is
18
+ * read in full under the configured bound and handed to the gateway with the
19
+ * method, path, query and headers, and what comes back is written as it is.
20
+ * A refusal the listener makes itself is a status and a code, never a
21
+ * message from the request.
22
+ */
23
+ export declare class GatewayHttpServer {
24
+ private readonly options;
25
+ private readonly server;
26
+ private readonly select;
27
+ constructor(gateway: Gateway | GatewaySelector, options?: GatewayHttpServerOptions);
28
+ listen(port: number, host: string): Promise<AddressInfo>;
29
+ /** Stops accepting, lets requests in flight finish for a grace period, then closes what is left. */
30
+ close(graceMs?: number): Promise<void>;
31
+ private handle;
32
+ /** The host a request was addressed to, lower-cased and without a port; null when it named none. */
33
+ private static hostnameOf;
34
+ private own;
35
+ /** The whole body under a bound; declared or streamed, the bound is the bound. */
36
+ private static readBody;
37
+ /** Header names lower-cased, repeated values joined as Node joins them, `set-cookie` aside. */
38
+ private static headersOf;
39
+ private static write;
40
+ private static reply;
41
+ }
42
+ //# sourceMappingURL=GatewayHttpServer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GatewayHttpServer.d.ts","sourceRoot":"","sources":["../../src/http/GatewayHttpServer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAkB,KAAK,OAAO,EAAwB,MAAM,uBAAuB,CAAC;AAsB3F,MAAM,WAAW,wBAAwB;IACvC,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,GAAG,IAAI,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAGvC,OAAO,EAAE,OAAO,GAAG,eAAe,EACjB,OAAO,GAAE,wBAA6B;IAY5C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMrE,oGAAoG;IACvF,KAAK,CAAC,OAAO,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;YAQrC,MAAM;IAwCpB,oGAAoG;IACpG,OAAO,CAAC,MAAM,CAAC,UAAU;YAQX,GAAG;IAkDjB,kFAAkF;mBAC7D,QAAQ;IAgB7B,+FAA+F;IAC/F,OAAO,CAAC,MAAM,CAAC,SAAS;IASxB,OAAO,CAAC,MAAM,CAAC,KAAK;IASpB,OAAO,CAAC,MAAM,CAAC,KAAK;CAMrB"}
@@ -0,0 +1,195 @@
1
+ import { once } from "node:events";
2
+ import { createServer, } from "node:http";
3
+ import { GATEWAY_PREFIX } from "../gateway/Gateway.js";
4
+ import { METRICS_CONTENT_TYPE, RESPONSE_HEADERS } from "./Routes.js";
5
+ const REQUEST_TIMEOUT_MS = 30_000;
6
+ const HEADERS_TIMEOUT_MS = 10_000;
7
+ const KEEP_ALIVE_TIMEOUT_MS = 5_000;
8
+ /** The gateway's own routes, under its prefix; anything else under the prefix is 404. */
9
+ const OWN_ROUTES = ["healthz", "readyz", "status", "metrics"];
10
+ const ESCALATIONS = `${GATEWAY_PREFIX}/v1/escalations/`;
11
+ const INTENT_ID = /^[0-9a-f-]{36}$/;
12
+ class GuardError extends Error {
13
+ status;
14
+ code;
15
+ constructor(status, code) {
16
+ super(code);
17
+ this.status = status;
18
+ this.code = code;
19
+ this.name = "GuardError";
20
+ }
21
+ }
22
+ /**
23
+ * The interception listener. Every request is either the gateway's own
24
+ * (under `/_agentsafe`), passed through unchanged, or governed: the body is
25
+ * read in full under the configured bound and handed to the gateway with the
26
+ * method, path, query and headers, and what comes back is written as it is.
27
+ * A refusal the listener makes itself is a status and a code, never a
28
+ * message from the request.
29
+ */
30
+ export class GatewayHttpServer {
31
+ options;
32
+ server;
33
+ select;
34
+ constructor(gateway, options = {}) {
35
+ this.options = options;
36
+ this.select = typeof gateway === "function" ? gateway : () => gateway;
37
+ const handler = (request, response) => {
38
+ void this.handle(request, response);
39
+ };
40
+ this.server = createServer(handler);
41
+ this.server.requestTimeout = REQUEST_TIMEOUT_MS;
42
+ this.server.headersTimeout = HEADERS_TIMEOUT_MS;
43
+ this.server.keepAliveTimeout = KEEP_ALIVE_TIMEOUT_MS;
44
+ }
45
+ async listen(port, host) {
46
+ this.server.listen(port, host);
47
+ await once(this.server, "listening");
48
+ return this.server.address();
49
+ }
50
+ /** Stops accepting, lets requests in flight finish for a grace period, then closes what is left. */
51
+ async close(graceMs = 10_000) {
52
+ const closed = new Promise((resolve) => this.server.close(() => resolve()));
53
+ this.server.closeIdleConnections();
54
+ const timer = setTimeout(() => this.server.closeAllConnections(), graceMs);
55
+ await closed;
56
+ clearTimeout(timer);
57
+ }
58
+ async handle(request, response) {
59
+ try {
60
+ // Stryker disable next-line all: Node sets `url` on every request it hands out; the fallback satisfies the type.
61
+ const url = new URL(request.url ?? "/", "http://gateway.invalid");
62
+ const method = (request.method ?? "GET").toUpperCase();
63
+ const gateway = this.select(GatewayHttpServer.hostnameOf(request));
64
+ if (gateway === null)
65
+ throw new GuardError(421, "HOST_NOT_SERVED");
66
+ if (url.pathname === GATEWAY_PREFIX || url.pathname.startsWith(`${GATEWAY_PREFIX}/`)) {
67
+ return await this.own(gateway, method, url, request, response);
68
+ }
69
+ const plan = gateway.plan(method, url.pathname);
70
+ const body = await GatewayHttpServer.readBody(request, plan.kind === "GOVERN"
71
+ ? gateway.config.interception.maxBodyBytes
72
+ : gateway.config.upstream.maxResponseBytes);
73
+ const intercepted = {
74
+ method,
75
+ path: url.pathname,
76
+ search: url.search,
77
+ headers: GatewayHttpServer.headersOf(request),
78
+ body,
79
+ remoteAddress: request.socket.remoteAddress ?? null,
80
+ encrypted: request.socket.encrypted === true,
81
+ };
82
+ const answer = plan.kind === "GOVERN"
83
+ ? await gateway.govern(intercepted, plan.action)
84
+ : await gateway.passthrough(intercepted);
85
+ GatewayHttpServer.write(response, answer);
86
+ }
87
+ catch (error) {
88
+ if (error instanceof GuardError) {
89
+ GatewayHttpServer.reply(response, error.status, { code: error.code });
90
+ }
91
+ else {
92
+ GatewayHttpServer.reply(response, 500, { code: "INTERNAL_ERROR" });
93
+ }
94
+ }
95
+ }
96
+ /** The host a request was addressed to, lower-cased and without a port; null when it named none. */
97
+ static hostnameOf(request) {
98
+ const host = request.headers.host?.trim().toLowerCase();
99
+ if (host === undefined || host === "")
100
+ return null;
101
+ if (host.startsWith("["))
102
+ return host.slice(0, host.indexOf("]") + 1);
103
+ const separator = host.indexOf(":");
104
+ return separator === -1 ? host : host.slice(0, separator);
105
+ }
106
+ async own(gateway, method, url, request, response) {
107
+ if (url.pathname.startsWith(ESCALATIONS)) {
108
+ const rest = url.pathname.slice(ESCALATIONS.length).split("/");
109
+ const intentId = rest[0] ?? "";
110
+ if (!INTENT_ID.test(intentId))
111
+ throw new GuardError(404, "NOT_FOUND");
112
+ if (rest.length === 1 && method === "GET") {
113
+ const held = gateway.escalation(intentId);
114
+ if (held === null)
115
+ throw new GuardError(404, "ESCALATION_NOT_HELD");
116
+ return GatewayHttpServer.reply(response, 200, held);
117
+ }
118
+ if (rest.length === 2 && rest[1] === "resume" && method === "POST") {
119
+ // The body, if any, is read and discarded: the gateway holds the intent.
120
+ await GatewayHttpServer.readBody(request, 1024);
121
+ return GatewayHttpServer.write(response, await gateway.resume(intentId));
122
+ }
123
+ throw new GuardError(rest.length === 1 || rest[1] === "resume" ? 405 : 404, rest.length === 1 || rest[1] === "resume" ? "METHOD_NOT_ALLOWED" : "NOT_FOUND");
124
+ }
125
+ const name = url.pathname.slice(GATEWAY_PREFIX.length + 1);
126
+ if (!OWN_ROUTES.includes(name))
127
+ throw new GuardError(404, "NOT_FOUND");
128
+ if (method !== "GET")
129
+ throw new GuardError(405, "METHOD_NOT_ALLOWED");
130
+ switch (name) {
131
+ case "healthz":
132
+ return GatewayHttpServer.reply(response, 200, { status: "ok" });
133
+ case "readyz": {
134
+ const readiness = gateway.readiness();
135
+ return GatewayHttpServer.reply(response, readiness.ready ? 200 : 503, readiness.body);
136
+ }
137
+ case "status":
138
+ return GatewayHttpServer.reply(response, 200, gateway.status());
139
+ case "metrics": {
140
+ const token = this.options.metricsToken ?? null;
141
+ if (token !== null && request.headers.authorization !== `Bearer ${token}`) {
142
+ throw new GuardError(401, "UNAUTHORIZED");
143
+ }
144
+ response.writeHead(200, { ...RESPONSE_HEADERS, "content-type": METRICS_CONTENT_TYPE });
145
+ response.end(gateway.metricsText());
146
+ return;
147
+ }
148
+ }
149
+ }
150
+ /** The whole body under a bound; declared or streamed, the bound is the bound. */
151
+ static async readBody(request, maxBytes) {
152
+ const declared = Number(request.headers["content-length"]);
153
+ if (Number.isFinite(declared) && declared > maxBytes) {
154
+ throw new GuardError(413, "BODY_TOO_LARGE");
155
+ }
156
+ const chunks = [];
157
+ let size = 0;
158
+ for await (const chunk of request) {
159
+ const buffer = chunk;
160
+ size += buffer.length;
161
+ if (size > maxBytes)
162
+ throw new GuardError(413, "BODY_TOO_LARGE");
163
+ chunks.push(buffer);
164
+ }
165
+ return Buffer.concat(chunks);
166
+ }
167
+ /** Header names lower-cased, repeated values joined as Node joins them, `set-cookie` aside. */
168
+ static headersOf(request) {
169
+ const headers = {};
170
+ for (const [name, value] of Object.entries(request.headers)) {
171
+ if (value === undefined)
172
+ continue;
173
+ headers[name] = Array.isArray(value) ? value.join(", ") : value;
174
+ }
175
+ return headers;
176
+ }
177
+ static write(response, answer) {
178
+ // Stryker disable next-line ConditionalExpression: a reply is written once per request; the guard is defensive.
179
+ if (response.headersSent)
180
+ return;
181
+ for (const [name, value] of answer.headers)
182
+ response.appendHeader(name, value);
183
+ response.setHeader("content-length", String(answer.body.length));
184
+ response.writeHead(answer.status);
185
+ response.end(answer.body);
186
+ }
187
+ static reply(response, status, body) {
188
+ // Stryker disable next-line ConditionalExpression: a reply is written once per request; the guard is defensive.
189
+ if (response.headersSent)
190
+ return;
191
+ response.writeHead(status, RESPONSE_HEADERS);
192
+ response.end(JSON.stringify(body));
193
+ }
194
+ }
195
+ //# sourceMappingURL=GatewayHttpServer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GatewayHttpServer.js","sourceRoot":"","sources":["../../src/http/GatewayHttpServer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /** One request as the target saw it: enough to say what arrived, never more. */
2
+ export interface ReceivedRequest {
3
+ readonly method: string;
4
+ readonly path: string;
5
+ /** Header names only, lowercased; a value is never kept. */
6
+ readonly headerNames: readonly string[];
7
+ readonly bodyBytes: number;
8
+ }
9
+ export declare class RecordingTarget {
10
+ readonly received: ReceivedRequest[];
11
+ private server;
12
+ private port;
13
+ get baseUrl(): string;
14
+ start(): Promise<void>;
15
+ stop(): Promise<void>;
16
+ private handle;
17
+ }
18
+ //# sourceMappingURL=RecordingTarget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RecordingTarget.d.ts","sourceRoot":"","sources":["../../src/http/RecordingTarget.ts"],"names":[],"mappings":"AAUA,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAKD,qBAAa,eAAe;IAC1B,SAAgB,QAAQ,EAAE,eAAe,EAAE,CAAM;IACjD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAAK;IAEjB,IAAW,OAAO,IAAI,MAAM,CAE3B;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAQpB,MAAM;CA0BrB"}
@@ -0,0 +1,71 @@
1
+ /**
2
+ * The synthetic target `agentsafe test` fires at: a loopback service that
3
+ * records what reaches it and answers the way a plain API would (200 to a
4
+ * read, 201 to a write, 204 to a delete), echoing what it received. It is
5
+ * the whole point of the test that this is the only thing a probe can
6
+ * touch: nothing it records is real, nothing outside this process is
7
+ * called, and it listens on the loopback interface alone.
8
+ */
9
+ import { createServer } from "node:http";
10
+ const LOOPBACK = "127.0.0.1";
11
+ const MAX_BODY_BYTES = 1024 * 1024;
12
+ export class RecordingTarget {
13
+ received = [];
14
+ server = null;
15
+ port = 0;
16
+ get baseUrl() {
17
+ return `http://${LOOPBACK}:${String(this.port)}`;
18
+ }
19
+ async start() {
20
+ if (this.server !== null)
21
+ return;
22
+ const server = createServer((request, response) => {
23
+ void this.handle(request, response);
24
+ });
25
+ await new Promise((resolve, reject) => {
26
+ server.once("error", reject);
27
+ server.listen(0, LOOPBACK, () => {
28
+ server.off("error", reject);
29
+ resolve();
30
+ });
31
+ });
32
+ const address = server.address();
33
+ this.port = typeof address === "object" && address !== null ? address.port : 0;
34
+ this.server = server;
35
+ }
36
+ async stop() {
37
+ const server = this.server;
38
+ if (server === null)
39
+ return;
40
+ this.server = null;
41
+ server.closeAllConnections();
42
+ await new Promise((resolve) => server.close(() => resolve()));
43
+ }
44
+ async handle(request, response) {
45
+ let bodyBytes = 0;
46
+ for await (const chunk of request) {
47
+ bodyBytes += chunk.length;
48
+ if (bodyBytes > MAX_BODY_BYTES) {
49
+ request.destroy();
50
+ return;
51
+ }
52
+ }
53
+ const method = request.method ?? "GET";
54
+ const path = (request.url ?? "/").split("?")[0] ?? "/";
55
+ this.received.push({
56
+ method,
57
+ path,
58
+ headerNames: Object.keys(request.headers).map((name) => name.toLowerCase()),
59
+ bodyBytes,
60
+ });
61
+ const status = method === "GET" || method === "HEAD" ? 200 : method === "DELETE" ? 204 : 201;
62
+ if (status === 204) {
63
+ response.writeHead(status);
64
+ response.end();
65
+ return;
66
+ }
67
+ response.writeHead(status, { "content-type": "application/json" });
68
+ response.end(JSON.stringify({ received: { method, path, body_bytes: bodyBytes } }));
69
+ }
70
+ }
71
+ //# sourceMappingURL=RecordingTarget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RecordingTarget.js","sourceRoot":"","sources":["../../src/http/RecordingTarget.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ /** What every line written while a request is handled may say about who asked. */
2
+ export interface RequestScope {
3
+ readonly principal: string;
4
+ }
5
+ /** The one caller a configuration without a principals file has: the holder of the caller token. */
6
+ export declare const LEGACY_CALLER_PRINCIPAL = "legacy-caller";
7
+ /**
8
+ * The request scope, carried through every await of a request so the
9
+ * evidence sink can name the principal without the service threading it
10
+ * through each call. Outside a request there is no scope, and a line says
11
+ * so with `null`.
12
+ */
13
+ export declare const RequestContext: {
14
+ run<T>(scope: RequestScope, fn: () => T): T;
15
+ current(): RequestScope | null;
16
+ };
17
+ //# sourceMappingURL=RequestContext.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../../src/http/RequestContext.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,oGAAoG;AACpG,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAIvD;;;;;GAKG;AACH,eAAO,MAAM,cAAc;QACrB,CAAC,SAAS,YAAY,MAAM,MAAM,CAAC,GAAG,CAAC;eAGhC,YAAY,GAAG,IAAI;CAG/B,CAAC"}
@@ -0,0 +1,19 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ /** The one caller a configuration without a principals file has: the holder of the caller token. */
3
+ export const LEGACY_CALLER_PRINCIPAL = "legacy-caller";
4
+ const storage = new AsyncLocalStorage();
5
+ /**
6
+ * The request scope, carried through every await of a request so the
7
+ * evidence sink can name the principal without the service threading it
8
+ * through each call. Outside a request there is no scope, and a line says
9
+ * so with `null`.
10
+ */
11
+ export const RequestContext = {
12
+ run(scope, fn) {
13
+ return storage.run(scope, fn);
14
+ },
15
+ current() {
16
+ return storage.getStore() ?? null;
17
+ },
18
+ };
19
+ //# sourceMappingURL=RequestContext.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RequestContext.js","sourceRoot":"","sources":["../../src/http/RequestContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,oGAAoG;AACpG,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEvD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAgB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,CAAI,KAAmB,EAAE,EAAW;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO;QACL,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;IACpC,CAAC;CACF,CAAC"}