@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,102 @@
1
+ import { type OperatorScope, type PrincipalEntry } from "./PrincipalsFile.js";
2
+ import { type RateLimitRule } from "./RateLimiter.js";
3
+ export type Role = "PROPOSER" | "OPERATOR";
4
+ export type ClaimValue = string | number | boolean;
5
+ export interface PrincipalActor {
6
+ readonly id: string;
7
+ readonly type: string;
8
+ readonly runtime?: string;
9
+ }
10
+ export type PrincipalCredential = {
11
+ readonly kind: "BEARER";
12
+ readonly digest: () => Uint8Array;
13
+ } | {
14
+ readonly kind: "MTLS";
15
+ readonly sanUri: string;
16
+ readonly fingerprint: string | null;
17
+ } | {
18
+ readonly kind: "WORKLOAD_JWT";
19
+ readonly issuer: string;
20
+ readonly subject: string;
21
+ readonly audience: string | null;
22
+ readonly requiredClaims: Readonly<Record<string, ClaimValue>>;
23
+ };
24
+ export interface Principal {
25
+ readonly id: string;
26
+ readonly role: Role;
27
+ /** A proposer's tenant and actor: what its intents carry. Null for an operator. */
28
+ readonly tenantId: string | null;
29
+ readonly actor: PrincipalActor | null;
30
+ readonly allowedActions: ReadonlySet<string>;
31
+ readonly scopes: ReadonlySet<OperatorScope>;
32
+ readonly credential: PrincipalCredential;
33
+ readonly rateLimit: RateLimitRule | null;
34
+ }
35
+ /** The one caller a configuration without a principals file has. */
36
+ export declare const LEGACY_CALLER_ID = "legacy-caller";
37
+ /** One credential kind's own shape, for a lookup that narrowed to it. */
38
+ type CredentialOf<TKind extends PrincipalCredential["kind"]> = Extract<PrincipalCredential, {
39
+ readonly kind: TKind;
40
+ }>;
41
+ export type Comparator = (a: Uint8Array, b: Uint8Array) => boolean;
42
+ export interface RegistryContext {
43
+ readonly registeredActions: Iterable<string>;
44
+ readonly jwtConfigured: boolean;
45
+ readonly mutualTls: boolean;
46
+ }
47
+ export interface LegacyContext {
48
+ readonly tenantId: string;
49
+ readonly actor: PrincipalActor;
50
+ readonly registeredActions: Iterable<string>;
51
+ /** The caller token's current digest; read at each comparison so rotation is followed. */
52
+ readonly callerToken: () => Uint8Array;
53
+ }
54
+ /**
55
+ * Who may call this process and as what. Built once, from the principals
56
+ * file or from the legacy caller the configuration names, and never changed
57
+ * while running. A bearer lookup hashes what was presented and compares it
58
+ * with every bearer digest in constant time, without stopping at a match,
59
+ * so timing says nothing about which principal, if any, it was.
60
+ */
61
+ export declare class PrincipalRegistry {
62
+ private readonly principals;
63
+ readonly legacy: boolean;
64
+ private readonly compare;
65
+ private readonly byId;
66
+ constructor(principals: readonly Principal[], legacy: boolean, compare?: Comparator);
67
+ /** The principals a file names, checked against what this process can run and verify. */
68
+ static fromEntries(entries: readonly PrincipalEntry[], context: RegistryContext, compare?: Comparator): PrincipalRegistry;
69
+ /** The legacy caller: one proposer, every registered action, the caller token as its credential. */
70
+ static legacy(context: LegacyContext, compare?: Comparator): PrincipalRegistry;
71
+ get size(): number;
72
+ get all(): readonly Principal[];
73
+ get proposers(): readonly Principal[];
74
+ get operators(): readonly Principal[];
75
+ principal(id: string): Principal | null;
76
+ /**
77
+ * The principals holding one kind of credential, narrowed once here rather
78
+ * than by a kind check inside every lookup. A lookup then reads only the
79
+ * fields its own kind has, and there is one place where the narrowing
80
+ * could be wrong.
81
+ */
82
+ private ofKind;
83
+ /** Every bearer digest is compared, in constant time, whether or not an earlier one matched. */
84
+ byBearerDigest(presented: string): Principal | null;
85
+ /** The principal a client certificate names by SAN URI, and pins by fingerprint when the file says so. */
86
+ byCertificate(sanUris: readonly string[], fingerprint: string): Principal | null;
87
+ issuerKnown(issuer: string): boolean;
88
+ /**
89
+ * The principal a workload token names, with its own credential, so the
90
+ * caller reads the issuer, audience and required claims without narrowing
91
+ * a second time.
92
+ */
93
+ byJwt(issuer: string, subject: string): {
94
+ readonly principal: Principal;
95
+ readonly credential: CredentialOf<"WORKLOAD_JWT">;
96
+ } | null;
97
+ /** The audiences named per principal, so the verifier accepts each; the global one is the default. */
98
+ audiences(): readonly string[];
99
+ private static credential;
100
+ }
101
+ export {};
102
+ //# sourceMappingURL=PrincipalRegistry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PrincipalRegistry.d.ts","sourceRoot":"","sources":["../../src/identity/PrincipalRegistry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,191 @@
1
+ import { createHash, timingSafeEqual } from "node:crypto";
2
+ import { normaliseFingerprint } from "./PeerIdentity.js";
3
+ import { PrincipalsError, } from "./PrincipalsFile.js";
4
+ import { RateLimiter } from "./RateLimiter.js";
5
+ /** The one caller a configuration without a principals file has. */
6
+ export const LEGACY_CALLER_ID = "legacy-caller";
7
+ /**
8
+ * Who may call this process and as what. Built once, from the principals
9
+ * file or from the legacy caller the configuration names, and never changed
10
+ * while running. A bearer lookup hashes what was presented and compares it
11
+ * with every bearer digest in constant time, without stopping at a match,
12
+ * so timing says nothing about which principal, if any, it was.
13
+ */
14
+ export class PrincipalRegistry {
15
+ principals;
16
+ legacy;
17
+ compare;
18
+ byId;
19
+ constructor(principals, legacy, compare = (a, b) => timingSafeEqual(a, b)) {
20
+ this.principals = principals;
21
+ this.legacy = legacy;
22
+ this.compare = compare;
23
+ this.byId = new Map(principals.map((principal) => [principal.id, principal]));
24
+ }
25
+ /** The principals a file names, checked against what this process can run and verify. */
26
+ static fromEntries(entries, context, compare) {
27
+ const registered = new Set(context.registeredActions);
28
+ const principals = entries.map((entry) => {
29
+ if (entry.credential.kind === "WORKLOAD_JWT" && !context.jwtConfigured) {
30
+ throw new PrincipalsError("PRINCIPALS_JWT_UNCONFIGURED", entry.id);
31
+ }
32
+ if (entry.credential.kind === "MTLS" && !context.mutualTls) {
33
+ throw new PrincipalsError("PRINCIPALS_MTLS_UNCONFIGURED", entry.id);
34
+ }
35
+ if (entry.role === "PROPOSER") {
36
+ for (const action of entry.allowed_actions) {
37
+ if (!registered.has(action)) {
38
+ throw new PrincipalsError("PRINCIPALS_UNKNOWN_ACTION", `${entry.id}/${action}`);
39
+ }
40
+ }
41
+ }
42
+ // The two roles carry different things, so they are built separately
43
+ // rather than by three checks of the same field with a fallback each.
44
+ const shared = {
45
+ id: entry.id,
46
+ role: entry.role,
47
+ credential: PrincipalRegistry.credential(entry.credential),
48
+ rateLimit: entry.rate_limit === undefined
49
+ ? null
50
+ : RateLimiter.parseRule(entry.rate_limit, `principals/${entry.id}/rate_limit`),
51
+ };
52
+ if (entry.role === "OPERATOR") {
53
+ return {
54
+ ...shared,
55
+ tenantId: null,
56
+ actor: null,
57
+ allowedActions: new Set(),
58
+ scopes: new Set(entry.scopes),
59
+ };
60
+ }
61
+ return {
62
+ ...shared,
63
+ tenantId: entry.tenant_id,
64
+ actor: {
65
+ id: entry.actor.id,
66
+ type: entry.actor.type,
67
+ // Absent rather than undefined: the actor travels inside the hashed
68
+ // intent, and a key with no value is not the same canonical form.
69
+ ...(entry.actor.runtime === undefined ? {} : { runtime: entry.actor.runtime }),
70
+ },
71
+ allowedActions: new Set(entry.allowed_actions),
72
+ scopes: new Set(),
73
+ };
74
+ });
75
+ return new PrincipalRegistry(principals, false, compare);
76
+ }
77
+ /** The legacy caller: one proposer, every registered action, the caller token as its credential. */
78
+ static legacy(context, compare) {
79
+ return new PrincipalRegistry([
80
+ {
81
+ id: LEGACY_CALLER_ID,
82
+ role: "PROPOSER",
83
+ tenantId: context.tenantId,
84
+ actor: context.actor,
85
+ allowedActions: new Set(context.registeredActions),
86
+ scopes: new Set(),
87
+ credential: { kind: "BEARER", digest: context.callerToken },
88
+ rateLimit: null,
89
+ },
90
+ ], true, compare);
91
+ }
92
+ get size() {
93
+ return this.principals.length;
94
+ }
95
+ get all() {
96
+ return this.principals;
97
+ }
98
+ get proposers() {
99
+ return this.principals.filter((principal) => principal.role === "PROPOSER");
100
+ }
101
+ get operators() {
102
+ return this.principals.filter((principal) => principal.role === "OPERATOR");
103
+ }
104
+ principal(id) {
105
+ return this.byId.get(id) ?? null;
106
+ }
107
+ /**
108
+ * The principals holding one kind of credential, narrowed once here rather
109
+ * than by a kind check inside every lookup. A lookup then reads only the
110
+ * fields its own kind has, and there is one place where the narrowing
111
+ * could be wrong.
112
+ */
113
+ ofKind(kind) {
114
+ const found = [];
115
+ for (const principal of this.principals) {
116
+ if (principal.credential.kind === kind) {
117
+ found.push({ principal, credential: principal.credential });
118
+ }
119
+ }
120
+ return found;
121
+ }
122
+ /** Every bearer digest is compared, in constant time, whether or not an earlier one matched. */
123
+ byBearerDigest(presented) {
124
+ const digest = createHash("sha256").update(presented).digest();
125
+ let found = null;
126
+ for (const { principal, credential } of this.ofKind("BEARER")) {
127
+ if (this.compare(digest, credential.digest()))
128
+ found = principal;
129
+ }
130
+ return found;
131
+ }
132
+ /** The principal a client certificate names by SAN URI, and pins by fingerprint when the file says so. */
133
+ byCertificate(sanUris, fingerprint) {
134
+ const presented = normaliseFingerprint(fingerprint);
135
+ for (const { principal, credential } of this.ofKind("MTLS")) {
136
+ if (!sanUris.includes(credential.sanUri))
137
+ continue;
138
+ if (credential.fingerprint !== null && credential.fingerprint !== presented)
139
+ return null;
140
+ return principal;
141
+ }
142
+ return null;
143
+ }
144
+ issuerKnown(issuer) {
145
+ return this.ofKind("WORKLOAD_JWT").some((entry) => entry.credential.issuer === issuer);
146
+ }
147
+ /**
148
+ * The principal a workload token names, with its own credential, so the
149
+ * caller reads the issuer, audience and required claims without narrowing
150
+ * a second time.
151
+ */
152
+ byJwt(issuer, subject) {
153
+ for (const entry of this.ofKind("WORKLOAD_JWT")) {
154
+ if (entry.credential.issuer === issuer && entry.credential.subject === subject)
155
+ return entry;
156
+ }
157
+ return null;
158
+ }
159
+ /** The audiences named per principal, so the verifier accepts each; the global one is the default. */
160
+ audiences() {
161
+ const named = new Set();
162
+ for (const { credential } of this.ofKind("WORKLOAD_JWT")) {
163
+ if (credential.audience !== null)
164
+ named.add(credential.audience);
165
+ }
166
+ return [...named];
167
+ }
168
+ static credential(entry) {
169
+ switch (entry.kind) {
170
+ case "BEARER": {
171
+ const digest = Buffer.from(entry.token_sha256, "hex");
172
+ return { kind: "BEARER", digest: () => digest };
173
+ }
174
+ case "MTLS":
175
+ return {
176
+ kind: "MTLS",
177
+ sanUri: entry.san_uri,
178
+ fingerprint: entry.cert_fingerprint_sha256 ?? null,
179
+ };
180
+ case "WORKLOAD_JWT":
181
+ return {
182
+ kind: "WORKLOAD_JWT",
183
+ issuer: entry.issuer,
184
+ subject: entry.subject,
185
+ audience: entry.audience ?? null,
186
+ requiredClaims: entry.required_claims ?? {},
187
+ };
188
+ }
189
+ }
190
+ }
191
+ //# sourceMappingURL=PrincipalRegistry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PrincipalRegistry.js","sourceRoot":"","sources":["../../src/identity/PrincipalRegistry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,152 @@
1
+ import { z } from "zod";
2
+ export declare const PRINCIPALS_VERSION = "agent-safe.principals/1";
3
+ export declare const MAX_PRINCIPALS = 200;
4
+ /** What an operator may do; each control route names the scope it needs. */
5
+ export declare const OPERATOR_SCOPES: readonly ["halt", "resume", "secrets.reload", "status", "metrics", "evidence"];
6
+ export type OperatorScope = (typeof OPERATOR_SCOPES)[number];
7
+ /**
8
+ * How a principal proves itself. The file holds identities and digests,
9
+ * never a token: a bearer credential is the SHA-256 of the token, a client
10
+ * certificate is named by its SAN URI and optionally pinned by fingerprint,
11
+ * and a workload token is named by issuer and subject.
12
+ */
13
+ export declare const PrincipalCredentialSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14
+ kind: z.ZodLiteral<"MTLS">;
15
+ san_uri: z.ZodString;
16
+ cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
17
+ }, z.core.$strict>, z.ZodObject<{
18
+ kind: z.ZodLiteral<"WORKLOAD_JWT">;
19
+ issuer: z.ZodString;
20
+ subject: z.ZodString;
21
+ audience: z.ZodOptional<z.ZodString>;
22
+ required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
23
+ }, z.core.$strict>, z.ZodObject<{
24
+ kind: z.ZodLiteral<"BEARER">;
25
+ token_sha256: z.ZodString;
26
+ }, z.core.$strict>], "kind">;
27
+ export declare const ProposerSchema: z.ZodObject<{
28
+ role: z.ZodLiteral<"PROPOSER">;
29
+ tenant_id: z.ZodString;
30
+ actor: z.ZodObject<{
31
+ id: z.ZodString;
32
+ type: z.ZodString;
33
+ runtime: z.ZodOptional<z.ZodString>;
34
+ }, z.core.$strict>;
35
+ allowed_actions: z.ZodArray<z.ZodString>;
36
+ id: z.ZodString;
37
+ credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
38
+ kind: z.ZodLiteral<"MTLS">;
39
+ san_uri: z.ZodString;
40
+ cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
41
+ }, z.core.$strict>, z.ZodObject<{
42
+ kind: z.ZodLiteral<"WORKLOAD_JWT">;
43
+ issuer: z.ZodString;
44
+ subject: z.ZodString;
45
+ audience: z.ZodOptional<z.ZodString>;
46
+ required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
47
+ }, z.core.$strict>, z.ZodObject<{
48
+ kind: z.ZodLiteral<"BEARER">;
49
+ token_sha256: z.ZodString;
50
+ }, z.core.$strict>], "kind">;
51
+ rate_limit: z.ZodOptional<z.ZodString>;
52
+ }, z.core.$strict>;
53
+ export declare const OperatorSchema: z.ZodObject<{
54
+ role: z.ZodLiteral<"OPERATOR">;
55
+ scopes: z.ZodArray<z.ZodEnum<{
56
+ status: "status";
57
+ "secrets.reload": "secrets.reload";
58
+ metrics: "metrics";
59
+ halt: "halt";
60
+ resume: "resume";
61
+ evidence: "evidence";
62
+ }>>;
63
+ id: z.ZodString;
64
+ credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
65
+ kind: z.ZodLiteral<"MTLS">;
66
+ san_uri: z.ZodString;
67
+ cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
68
+ }, z.core.$strict>, z.ZodObject<{
69
+ kind: z.ZodLiteral<"WORKLOAD_JWT">;
70
+ issuer: z.ZodString;
71
+ subject: z.ZodString;
72
+ audience: z.ZodOptional<z.ZodString>;
73
+ required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
74
+ }, z.core.$strict>, z.ZodObject<{
75
+ kind: z.ZodLiteral<"BEARER">;
76
+ token_sha256: z.ZodString;
77
+ }, z.core.$strict>], "kind">;
78
+ rate_limit: z.ZodOptional<z.ZodString>;
79
+ }, z.core.$strict>;
80
+ export declare const PrincipalsFileSchema: z.ZodObject<{
81
+ version: z.ZodLiteral<"agent-safe.principals/1">;
82
+ principals: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
83
+ role: z.ZodLiteral<"PROPOSER">;
84
+ tenant_id: z.ZodString;
85
+ actor: z.ZodObject<{
86
+ id: z.ZodString;
87
+ type: z.ZodString;
88
+ runtime: z.ZodOptional<z.ZodString>;
89
+ }, z.core.$strict>;
90
+ allowed_actions: z.ZodArray<z.ZodString>;
91
+ id: z.ZodString;
92
+ credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
93
+ kind: z.ZodLiteral<"MTLS">;
94
+ san_uri: z.ZodString;
95
+ cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
96
+ }, z.core.$strict>, z.ZodObject<{
97
+ kind: z.ZodLiteral<"WORKLOAD_JWT">;
98
+ issuer: z.ZodString;
99
+ subject: z.ZodString;
100
+ audience: z.ZodOptional<z.ZodString>;
101
+ required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
102
+ }, z.core.$strict>, z.ZodObject<{
103
+ kind: z.ZodLiteral<"BEARER">;
104
+ token_sha256: z.ZodString;
105
+ }, z.core.$strict>], "kind">;
106
+ rate_limit: z.ZodOptional<z.ZodString>;
107
+ }, z.core.$strict>, z.ZodObject<{
108
+ role: z.ZodLiteral<"OPERATOR">;
109
+ scopes: z.ZodArray<z.ZodEnum<{
110
+ status: "status";
111
+ "secrets.reload": "secrets.reload";
112
+ metrics: "metrics";
113
+ halt: "halt";
114
+ resume: "resume";
115
+ evidence: "evidence";
116
+ }>>;
117
+ id: z.ZodString;
118
+ credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
119
+ kind: z.ZodLiteral<"MTLS">;
120
+ san_uri: z.ZodString;
121
+ cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
122
+ }, z.core.$strict>, z.ZodObject<{
123
+ kind: z.ZodLiteral<"WORKLOAD_JWT">;
124
+ issuer: z.ZodString;
125
+ subject: z.ZodString;
126
+ audience: z.ZodOptional<z.ZodString>;
127
+ required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
128
+ }, z.core.$strict>, z.ZodObject<{
129
+ kind: z.ZodLiteral<"BEARER">;
130
+ token_sha256: z.ZodString;
131
+ }, z.core.$strict>], "kind">;
132
+ rate_limit: z.ZodOptional<z.ZodString>;
133
+ }, z.core.$strict>], "role">>;
134
+ }, z.core.$strict>;
135
+ export type PrincipalEntry = z.infer<typeof PrincipalsFileSchema>["principals"][number];
136
+ export type PrincipalCredentialEntry = z.infer<typeof PrincipalCredentialSchema>;
137
+ /** A refusal to load principals: the code and the entry or path it concerns, never a value. */
138
+ export declare class PrincipalsError extends Error {
139
+ readonly code: string;
140
+ readonly subject: string | null;
141
+ constructor(code: string, subject?: string | null);
142
+ }
143
+ /** The identity a credential asserts; two principals may never share one. */
144
+ export declare function credentialIdentity(credential: PrincipalCredentialEntry): string;
145
+ /**
146
+ * Parses and checks a principals file: the schema, then no duplicate id and
147
+ * no credential identity claimed twice. What it cannot check here, that
148
+ * every allowed action is registered and every credential kind has what it
149
+ * needs, the registry checks when it is built.
150
+ */
151
+ export declare function parsePrincipalsFile(text: string): readonly PrincipalEntry[];
152
+ //# sourceMappingURL=PrincipalsFile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PrincipalsFile.d.ts","sourceRoot":"","sources":["../../src/identity/PrincipalsFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,4EAA4E;AAC5E,eAAO,MAAM,eAAe,gFAOlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAU7D;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;4BAmBpC,CAAC;AASH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;kBAMzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,+FAA+F;AAC/F,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,MAAM,GAAG,IAAI;gBADtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,GAAG,IAAW;CAKhD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,wBAAwB,GAAG,MAAM,CAS/E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CA0B3E"}
@@ -0,0 +1,125 @@
1
+ import { z } from "zod";
2
+ export const PRINCIPALS_VERSION = "agent-safe.principals/1";
3
+ export const MAX_PRINCIPALS = 200;
4
+ /** What an operator may do; each control route names the scope it needs. */
5
+ export const OPERATOR_SCOPES = [
6
+ "halt",
7
+ "resume",
8
+ "secrets.reload",
9
+ "status",
10
+ "metrics",
11
+ "evidence",
12
+ ];
13
+ const identifier = z.string().trim().min(1).max(200);
14
+ const hex64 = z.string().regex(/^[0-9a-f]{64}$/);
15
+ // Bounded here, and read as a rule by the registry: `RateLimiter.parseRule`
16
+ // is what a rate rule means, and its refusal names the principal by id
17
+ // rather than by its position in the file.
18
+ const rateLimit = z.string().trim().min(1).max(20);
19
+ const claimValue = z.union([z.string().max(500), z.number(), z.boolean()]);
20
+ /**
21
+ * How a principal proves itself. The file holds identities and digests,
22
+ * never a token: a bearer credential is the SHA-256 of the token, a client
23
+ * certificate is named by its SAN URI and optionally pinned by fingerprint,
24
+ * and a workload token is named by issuer and subject.
25
+ */
26
+ export const PrincipalCredentialSchema = z.discriminatedUnion("kind", [
27
+ z.strictObject({
28
+ kind: z.literal("MTLS"),
29
+ san_uri: z
30
+ .string()
31
+ .trim()
32
+ .min(1)
33
+ .max(500)
34
+ .regex(/^[a-z][a-z0-9+.-]*:/i),
35
+ cert_fingerprint_sha256: hex64.optional(),
36
+ }),
37
+ z.strictObject({
38
+ kind: z.literal("WORKLOAD_JWT"),
39
+ issuer: z.string().trim().min(1).max(500),
40
+ subject: z.string().trim().min(1).max(500),
41
+ audience: z.string().trim().min(1).max(200).optional(),
42
+ required_claims: z.record(z.string().min(1).max(200), claimValue).optional(),
43
+ }),
44
+ z.strictObject({ kind: z.literal("BEARER"), token_sha256: hex64 }),
45
+ ]);
46
+ const common = {
47
+ id: identifier,
48
+ credential: PrincipalCredentialSchema,
49
+ /** `<count>/<seconds>`: how many requests this principal may make per window. */
50
+ rate_limit: rateLimit.optional(),
51
+ };
52
+ export const ProposerSchema = z.strictObject({
53
+ ...common,
54
+ role: z.literal("PROPOSER"),
55
+ tenant_id: z.string().uuid(),
56
+ actor: z.strictObject({ id: identifier, type: identifier, runtime: identifier.optional() }),
57
+ allowed_actions: z.array(z.string().trim().min(1).max(120)).min(1).max(50),
58
+ });
59
+ export const OperatorSchema = z.strictObject({
60
+ ...common,
61
+ role: z.literal("OPERATOR"),
62
+ scopes: z.array(z.enum(OPERATOR_SCOPES)).min(1).max(OPERATOR_SCOPES.length),
63
+ });
64
+ export const PrincipalsFileSchema = z.strictObject({
65
+ version: z.literal(PRINCIPALS_VERSION),
66
+ principals: z
67
+ .array(z.discriminatedUnion("role", [ProposerSchema, OperatorSchema]))
68
+ .min(1)
69
+ .max(MAX_PRINCIPALS),
70
+ });
71
+ /** A refusal to load principals: the code and the entry or path it concerns, never a value. */
72
+ export class PrincipalsError extends Error {
73
+ code;
74
+ subject;
75
+ constructor(code, subject = null) {
76
+ super(subject === null ? code : `${code}: ${subject}`);
77
+ this.code = code;
78
+ this.subject = subject;
79
+ this.name = "PrincipalsError";
80
+ }
81
+ }
82
+ /** The identity a credential asserts; two principals may never share one. */
83
+ export function credentialIdentity(credential) {
84
+ switch (credential.kind) {
85
+ case "BEARER":
86
+ return `BEARER:${credential.token_sha256}`;
87
+ case "MTLS":
88
+ return `MTLS:${credential.san_uri}`;
89
+ case "WORKLOAD_JWT":
90
+ return `WORKLOAD_JWT:${credential.issuer}|${credential.subject}`;
91
+ }
92
+ }
93
+ /**
94
+ * Parses and checks a principals file: the schema, then no duplicate id and
95
+ * no credential identity claimed twice. What it cannot check here, that
96
+ * every allowed action is registered and every credential kind has what it
97
+ * needs, the registry checks when it is built.
98
+ */
99
+ export function parsePrincipalsFile(text) {
100
+ let parsed;
101
+ try {
102
+ parsed = JSON.parse(text);
103
+ }
104
+ catch {
105
+ throw new PrincipalsError("PRINCIPALS_INVALID", "not JSON");
106
+ }
107
+ const result = PrincipalsFileSchema.safeParse(parsed);
108
+ if (!result.success) {
109
+ const issue = result.error.issues[0];
110
+ throw new PrincipalsError("PRINCIPALS_INVALID", issue === undefined ? null : issue.path.join("."));
111
+ }
112
+ const ids = new Set();
113
+ const identities = new Set();
114
+ for (const entry of result.data.principals) {
115
+ if (ids.has(entry.id))
116
+ throw new PrincipalsError("PRINCIPALS_DUPLICATE_ID", entry.id);
117
+ ids.add(entry.id);
118
+ const identity = credentialIdentity(entry.credential);
119
+ if (identities.has(identity))
120
+ throw new PrincipalsError("PRINCIPALS_CREDENTIAL_SHARED", entry.id);
121
+ identities.add(identity);
122
+ }
123
+ return result.data.principals;
124
+ }
125
+ //# sourceMappingURL=PrincipalsFile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PrincipalsFile.js","sourceRoot":"","sources":["../../src/identity/PrincipalsFile.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ export interface RateLimitRule {
2
+ readonly count: number;
3
+ readonly windowSeconds: number;
4
+ }
5
+ export interface LockoutRule {
6
+ readonly failures: number;
7
+ readonly windowSeconds: number;
8
+ readonly lockSeconds: number;
9
+ }
10
+ /**
11
+ * `<count>/<seconds>`, the one definition of a rate rule in this package. The
12
+ * principals file validates a rule by parsing it through `parseRule` rather
13
+ * than restating this pattern, so there is no second copy to drift from it.
14
+ */
15
+ export declare const RATE_RULE_PATTERN: RegExp;
16
+ /**
17
+ * Sliding windows keyed by principal id, plus one key for requests that
18
+ * never became a principal. Memory is bounded by the registry: a key holds
19
+ * at most its rule's count of timestamps, and there is no key a caller can
20
+ * invent. A lockout engages when a principal's authentication failures reach
21
+ * the rule inside its window, and ends only when the lock expires or the
22
+ * process restarts.
23
+ */
24
+ export declare class RateLimiter {
25
+ private readonly clock;
26
+ private readonly hits;
27
+ private readonly failures;
28
+ private readonly locks;
29
+ constructor(clock?: () => number);
30
+ /** `<count>/<seconds>`; a refusal names the variable. */
31
+ static parseRule(text: string, key: string): RateLimitRule;
32
+ /** `<failures>/<seconds>/<lock seconds>`; zero failures disables the lockout. */
33
+ static parseLockout(text: string, key: string): LockoutRule | null;
34
+ /** Whether the key has room under the rule right now, without taking any. */
35
+ exhausted(key: string, rule: RateLimitRule): boolean;
36
+ /** Takes one request from the key's window; false when the window is full. */
37
+ allow(key: string, rule: RateLimitRule): boolean;
38
+ /** Records an authentication failure; true when this one engaged the lock. */
39
+ recordFailure(key: string, rule: LockoutRule | null): boolean;
40
+ locked(key: string): boolean;
41
+ private recent;
42
+ }
43
+ //# sourceMappingURL=RateLimiter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/identity/RateLimiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAqC,CAAC;AAGpE;;;;;;;GAOG;AACH,qBAAa,WAAW;IAKH,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;gBAEf,KAAK,GAAE,MAAM,MAAyB;IAE1E,yDAAyD;WAC3C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAMjE,iFAAiF;WACnE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUzE,6EAA6E;IACtE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO;IAI3D,8EAA8E;IACvE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO;IAQvD,8EAA8E;IACvE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO;IAW7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQnC,OAAO,CAAC,MAAM;CAMf"}