@decionis/agentsafe 0.2.4 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (320) hide show
  1. package/README.md +135 -20
  2. package/dist/Cli.js +20 -0
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +22 -5
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +19 -2
  7. package/dist/Index.js.map +1 -1
  8. package/dist/TrustedExecutor.d.ts.map +1 -1
  9. package/dist/TrustedExecutor.js +1 -0
  10. package/dist/TrustedExecutor.js.map +1 -1
  11. package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
  12. package/dist/adapters/AdapterActionHandler.js +8 -4
  13. package/dist/adapters/AdapterActionHandler.js.map +1 -1
  14. package/dist/adapters/EffectAdapter.d.ts +6 -1
  15. package/dist/adapters/EffectAdapter.d.ts.map +1 -1
  16. package/dist/adapters/EffectAdapter.js +7 -1
  17. package/dist/adapters/EffectAdapter.js.map +1 -1
  18. package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
  19. package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
  20. package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
  21. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
  22. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
  23. package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
  24. package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
  25. package/dist/adapters/cards/CardEffect.d.ts +52 -0
  26. package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
  27. package/dist/adapters/cards/CardEffect.js +117 -0
  28. package/dist/adapters/cards/CardEffect.js.map +1 -0
  29. package/dist/adapters/cards/CardHandlers.d.ts +15 -0
  30. package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
  31. package/dist/adapters/cards/CardHandlers.js +26 -0
  32. package/dist/adapters/cards/CardHandlers.js.map +1 -0
  33. package/dist/adapters/cards/CardPurchase.d.ts +61 -0
  34. package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
  35. package/dist/adapters/cards/CardPurchase.js +116 -0
  36. package/dist/adapters/cards/CardPurchase.js.map +1 -0
  37. package/dist/adapters/cards/HeldCardGrants.d.ts +70 -0
  38. package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
  39. package/dist/adapters/cards/HeldCardGrants.js +79 -0
  40. package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
  41. package/dist/adapters/cards/Pan.d.ts +17 -0
  42. package/dist/adapters/cards/Pan.d.ts.map +1 -0
  43. package/dist/adapters/cards/Pan.js +52 -0
  44. package/dist/adapters/cards/Pan.js.map +1 -0
  45. package/dist/adapters/mcp/McpGuard.d.ts +91 -0
  46. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -0
  47. package/dist/adapters/mcp/McpGuard.js +147 -0
  48. package/dist/adapters/mcp/McpGuard.js.map +1 -0
  49. package/dist/adapters/mcp/McpIntentBinder.d.ts +54 -0
  50. package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -0
  51. package/dist/adapters/mcp/McpIntentBinder.js +79 -0
  52. package/dist/adapters/mcp/McpIntentBinder.js.map +1 -0
  53. package/dist/adapters/mcp/McpInvocation.d.ts +55 -0
  54. package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -0
  55. package/dist/adapters/mcp/McpInvocation.js +88 -0
  56. package/dist/adapters/mcp/McpInvocation.js.map +1 -0
  57. package/dist/audit/HashChain.d.ts +8 -2
  58. package/dist/audit/HashChain.d.ts.map +1 -1
  59. package/dist/audit/HashChain.js +14 -2
  60. package/dist/audit/HashChain.js.map +1 -1
  61. package/dist/boundary/BoundaryIdentity.d.ts +88 -0
  62. package/dist/boundary/BoundaryIdentity.d.ts.map +1 -0
  63. package/dist/boundary/BoundaryIdentity.js +126 -0
  64. package/dist/boundary/BoundaryIdentity.js.map +1 -0
  65. package/dist/cli/Commands.d.ts +1 -1
  66. package/dist/cli/Commands.d.ts.map +1 -1
  67. package/dist/cli/Commands.js +10 -0
  68. package/dist/cli/Commands.js.map +1 -1
  69. package/dist/cli/Edge.d.ts +4 -0
  70. package/dist/cli/Edge.d.ts.map +1 -0
  71. package/dist/cli/Edge.js +250 -0
  72. package/dist/cli/Edge.js.map +1 -0
  73. package/dist/cli/Help.d.ts.map +1 -1
  74. package/dist/cli/Help.js +9 -0
  75. package/dist/cli/Help.js.map +1 -1
  76. package/dist/cli/Host.d.ts +36 -0
  77. package/dist/cli/Host.d.ts.map +1 -0
  78. package/dist/cli/Host.js +247 -0
  79. package/dist/cli/Host.js.map +1 -0
  80. package/dist/cli/Identity.d.ts +47 -0
  81. package/dist/cli/Identity.d.ts.map +1 -0
  82. package/dist/cli/Identity.js +145 -0
  83. package/dist/cli/Identity.js.map +1 -0
  84. package/dist/cli/TcpBrokerCli.d.ts +4 -0
  85. package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
  86. package/dist/cli/TcpBrokerCli.js +93 -0
  87. package/dist/cli/TcpBrokerCli.js.map +1 -0
  88. package/dist/cli/TcpClientCli.d.ts +16 -0
  89. package/dist/cli/TcpClientCli.d.ts.map +1 -0
  90. package/dist/cli/TcpClientCli.js +175 -0
  91. package/dist/cli/TcpClientCli.js.map +1 -0
  92. package/dist/cli/TestCommand.d.ts +8 -0
  93. package/dist/cli/TestCommand.d.ts.map +1 -1
  94. package/dist/cli/TestCommand.js +25 -5
  95. package/dist/cli/TestCommand.js.map +1 -1
  96. package/dist/config/ConfigKeys.d.ts +2 -2
  97. package/dist/config/ConfigKeys.d.ts.map +1 -1
  98. package/dist/config/ConfigKeys.js +19 -0
  99. package/dist/config/ConfigKeys.js.map +1 -1
  100. package/dist/config/ExecutorConfig.d.ts +62 -0
  101. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  102. package/dist/config/ExecutorConfig.js +124 -0
  103. package/dist/config/ExecutorConfig.js.map +1 -1
  104. package/dist/edge/EdgeLicence.d.ts +25 -0
  105. package/dist/edge/EdgeLicence.d.ts.map +1 -0
  106. package/dist/edge/EdgeLicence.js +42 -0
  107. package/dist/edge/EdgeLicence.js.map +1 -0
  108. package/dist/edge/EdgeReplay.d.ts +45 -0
  109. package/dist/edge/EdgeReplay.d.ts.map +1 -0
  110. package/dist/edge/EdgeReplay.js +69 -0
  111. package/dist/edge/EdgeReplay.js.map +1 -0
  112. package/dist/edge/Entitlement.d.ts +57 -0
  113. package/dist/edge/Entitlement.d.ts.map +1 -0
  114. package/dist/edge/Entitlement.js +139 -0
  115. package/dist/edge/Entitlement.js.map +1 -0
  116. package/dist/edge/EntitlementEvaluation.d.ts +66 -0
  117. package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
  118. package/dist/edge/EntitlementEvaluation.js +74 -0
  119. package/dist/edge/EntitlementEvaluation.js.map +1 -0
  120. package/dist/edge/UsageCount.d.ts +40 -0
  121. package/dist/edge/UsageCount.d.ts.map +1 -0
  122. package/dist/edge/UsageCount.js +140 -0
  123. package/dist/edge/UsageCount.js.map +1 -0
  124. package/dist/edge/UsageKeyRegistration.d.ts +34 -0
  125. package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
  126. package/dist/edge/UsageKeyRegistration.js +74 -0
  127. package/dist/edge/UsageKeyRegistration.js.map +1 -0
  128. package/dist/edge/UsageMeter.d.ts +89 -0
  129. package/dist/edge/UsageMeter.d.ts.map +1 -0
  130. package/dist/edge/UsageMeter.js +275 -0
  131. package/dist/edge/UsageMeter.js.map +1 -0
  132. package/dist/edge/UsagePeriod.d.ts +23 -0
  133. package/dist/edge/UsagePeriod.d.ts.map +1 -0
  134. package/dist/edge/UsagePeriod.js +31 -0
  135. package/dist/edge/UsagePeriod.js.map +1 -0
  136. package/dist/edge/UsageReport.d.ts +92 -0
  137. package/dist/edge/UsageReport.d.ts.map +1 -0
  138. package/dist/edge/UsageReport.js +153 -0
  139. package/dist/edge/UsageReport.js.map +1 -0
  140. package/dist/edge/UsageTally.d.ts +63 -0
  141. package/dist/edge/UsageTally.d.ts.map +1 -0
  142. package/dist/edge/UsageTally.js +89 -0
  143. package/dist/edge/UsageTally.js.map +1 -0
  144. package/dist/egress/EgressError.d.ts +7 -1
  145. package/dist/egress/EgressError.d.ts.map +1 -1
  146. package/dist/egress/EgressError.js.map +1 -1
  147. package/dist/egress/EgressPolicy.d.ts +16 -3
  148. package/dist/egress/EgressPolicy.d.ts.map +1 -1
  149. package/dist/egress/EgressPolicy.js +33 -3
  150. package/dist/egress/EgressPolicy.js.map +1 -1
  151. package/dist/egress/GuardedFetch.d.ts +38 -1
  152. package/dist/egress/GuardedFetch.d.ts.map +1 -1
  153. package/dist/egress/GuardedFetch.js +52 -7
  154. package/dist/egress/GuardedFetch.js.map +1 -1
  155. package/dist/egress/TcpClient.d.ts +103 -0
  156. package/dist/egress/TcpClient.d.ts.map +1 -0
  157. package/dist/egress/TcpClient.js +490 -0
  158. package/dist/egress/TcpClient.js.map +1 -0
  159. package/dist/egress/TcpControlClient.d.ts +49 -0
  160. package/dist/egress/TcpControlClient.d.ts.map +1 -0
  161. package/dist/egress/TcpControlClient.js +186 -0
  162. package/dist/egress/TcpControlClient.js.map +1 -0
  163. package/dist/gateway/AuthorityAttacks.d.ts +39 -0
  164. package/dist/gateway/AuthorityAttacks.d.ts.map +1 -0
  165. package/dist/gateway/AuthorityAttacks.js +158 -0
  166. package/dist/gateway/AuthorityAttacks.js.map +1 -0
  167. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  168. package/dist/gateway/ForwardHandler.js +7 -4
  169. package/dist/gateway/ForwardHandler.js.map +1 -1
  170. package/dist/gateway/Gateway.d.ts +197 -10
  171. package/dist/gateway/Gateway.d.ts.map +1 -1
  172. package/dist/gateway/Gateway.js +524 -63
  173. package/dist/gateway/Gateway.js.map +1 -1
  174. package/dist/gateway/GatewayConfig.d.ts +78 -0
  175. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  176. package/dist/gateway/GatewayConfig.js +167 -2
  177. package/dist/gateway/GatewayConfig.js.map +1 -1
  178. package/dist/gateway/GatewayReport.d.ts +31 -1
  179. package/dist/gateway/GatewayReport.d.ts.map +1 -1
  180. package/dist/gateway/GatewayReport.js +12 -0
  181. package/dist/gateway/GatewayReport.js.map +1 -1
  182. package/dist/gateway/InterceptedRequest.d.ts +9 -2
  183. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  184. package/dist/gateway/InterceptedRequest.js +41 -9
  185. package/dist/gateway/InterceptedRequest.js.map +1 -1
  186. package/dist/gateway/RateLimit.d.ts +29 -0
  187. package/dist/gateway/RateLimit.d.ts.map +1 -0
  188. package/dist/gateway/RateLimit.js +33 -0
  189. package/dist/gateway/RateLimit.js.map +1 -0
  190. package/dist/gateway/RefusalSampler.d.ts +28 -0
  191. package/dist/gateway/RefusalSampler.d.ts.map +1 -0
  192. package/dist/gateway/RefusalSampler.js +52 -0
  193. package/dist/gateway/RefusalSampler.js.map +1 -0
  194. package/dist/gateway/RouteTable.d.ts +3 -0
  195. package/dist/gateway/RouteTable.d.ts.map +1 -1
  196. package/dist/gateway/RouteTable.js +44 -7
  197. package/dist/gateway/RouteTable.js.map +1 -1
  198. package/dist/gateway/Upstream.d.ts +26 -0
  199. package/dist/gateway/Upstream.d.ts.map +1 -1
  200. package/dist/gateway/Upstream.js +41 -2
  201. package/dist/gateway/Upstream.js.map +1 -1
  202. package/dist/gateway/UpstreamProof.d.ts +235 -0
  203. package/dist/gateway/UpstreamProof.d.ts.map +1 -0
  204. package/dist/gateway/UpstreamProof.js +375 -0
  205. package/dist/gateway/UpstreamProof.js.map +1 -0
  206. package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
  207. package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
  208. package/dist/handlers/ForwardRequestHandler.js +12 -2
  209. package/dist/handlers/ForwardRequestHandler.js.map +1 -1
  210. package/dist/hosted/TenantHost.d.ts +180 -0
  211. package/dist/hosted/TenantHost.d.ts.map +1 -0
  212. package/dist/hosted/TenantHost.js +432 -0
  213. package/dist/hosted/TenantHost.js.map +1 -0
  214. package/dist/hosted/TenantRegistry.d.ts +73 -0
  215. package/dist/hosted/TenantRegistry.d.ts.map +1 -0
  216. package/dist/hosted/TenantRegistry.js +123 -0
  217. package/dist/hosted/TenantRegistry.js.map +1 -0
  218. package/dist/http/ExecutorHttpServer.d.ts +7 -0
  219. package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
  220. package/dist/http/ExecutorHttpServer.js +30 -5
  221. package/dist/http/ExecutorHttpServer.js.map +1 -1
  222. package/dist/http/GatewayHttpServer.d.ts +55 -3
  223. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  224. package/dist/http/GatewayHttpServer.js +157 -17
  225. package/dist/http/GatewayHttpServer.js.map +1 -1
  226. package/dist/http/RedirectServer.d.ts +26 -0
  227. package/dist/http/RedirectServer.d.ts.map +1 -0
  228. package/dist/http/RedirectServer.js +62 -0
  229. package/dist/http/RedirectServer.js.map +1 -0
  230. package/dist/http/Routes.d.ts +17 -0
  231. package/dist/http/Routes.d.ts.map +1 -1
  232. package/dist/http/Routes.js +21 -0
  233. package/dist/http/Routes.js.map +1 -1
  234. package/dist/http/TcpBroker.d.ts +57 -0
  235. package/dist/http/TcpBroker.d.ts.map +1 -0
  236. package/dist/http/TcpBroker.js +299 -0
  237. package/dist/http/TcpBroker.js.map +1 -0
  238. package/dist/http/TcpHostRelay.d.ts +24 -0
  239. package/dist/http/TcpHostRelay.d.ts.map +1 -0
  240. package/dist/http/TcpHostRelay.js +194 -0
  241. package/dist/http/TcpHostRelay.js.map +1 -0
  242. package/dist/http/TcpRelayStreams.d.ts +24 -0
  243. package/dist/http/TcpRelayStreams.d.ts.map +1 -0
  244. package/dist/http/TcpRelayStreams.js +128 -0
  245. package/dist/http/TcpRelayStreams.js.map +1 -0
  246. package/dist/http/TlsListener.d.ts +3 -1
  247. package/dist/http/TlsListener.d.ts.map +1 -1
  248. package/dist/http/TlsListener.js +7 -2
  249. package/dist/http/TlsListener.js.map +1 -1
  250. package/dist/identity/PrincipalsFile.d.ts +3 -1
  251. package/dist/identity/PrincipalsFile.d.ts.map +1 -1
  252. package/dist/identity/PrincipalsFile.js +1 -0
  253. package/dist/identity/PrincipalsFile.js.map +1 -1
  254. package/dist/incident/Metrics.d.ts +2 -0
  255. package/dist/incident/Metrics.d.ts.map +1 -1
  256. package/dist/incident/Metrics.js +10 -0
  257. package/dist/incident/Metrics.js.map +1 -1
  258. package/dist/incident/SecurityEvents.d.ts +89 -0
  259. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  260. package/dist/incident/SecurityEvents.js +93 -2
  261. package/dist/incident/SecurityEvents.js.map +1 -1
  262. package/dist/journal/ExecutionJournal.d.ts +27 -0
  263. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  264. package/dist/journal/ExecutionJournal.js +28 -0
  265. package/dist/journal/ExecutionJournal.js.map +1 -1
  266. package/dist/journal/FileExecutionJournal.d.ts +2 -1
  267. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  268. package/dist/journal/FileExecutionJournal.js +4 -1
  269. package/dist/journal/FileExecutionJournal.js.map +1 -1
  270. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  271. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  272. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  273. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  274. package/dist/provenance/DockerProvenanceProvider.d.ts +23 -0
  275. package/dist/provenance/DockerProvenanceProvider.d.ts.map +1 -0
  276. package/dist/provenance/DockerProvenanceProvider.js +24 -0
  277. package/dist/provenance/DockerProvenanceProvider.js.map +1 -0
  278. package/dist/provenance/KubernetesProvenanceProvider.d.ts +17 -0
  279. package/dist/provenance/KubernetesProvenanceProvider.d.ts.map +1 -0
  280. package/dist/provenance/KubernetesProvenanceProvider.js +18 -0
  281. package/dist/provenance/KubernetesProvenanceProvider.js.map +1 -0
  282. package/dist/provenance/NoneProvenanceProvider.d.ts +15 -0
  283. package/dist/provenance/NoneProvenanceProvider.d.ts.map +1 -0
  284. package/dist/provenance/NoneProvenanceProvider.js +16 -0
  285. package/dist/provenance/NoneProvenanceProvider.js.map +1 -0
  286. package/dist/provenance/ProvenanceProvider.d.ts +94 -0
  287. package/dist/provenance/ProvenanceProvider.d.ts.map +1 -0
  288. package/dist/provenance/ProvenanceProvider.js +118 -0
  289. package/dist/provenance/ProvenanceProvider.js.map +1 -0
  290. package/dist/provenance/StaticProvenanceProvider.d.ts +18 -0
  291. package/dist/provenance/StaticProvenanceProvider.d.ts.map +1 -0
  292. package/dist/provenance/StaticProvenanceProvider.js +25 -0
  293. package/dist/provenance/StaticProvenanceProvider.js.map +1 -0
  294. package/dist/service/AuthorityClients.d.ts +8 -1
  295. package/dist/service/AuthorityClients.d.ts.map +1 -1
  296. package/dist/service/AuthorityClients.js +33 -5
  297. package/dist/service/AuthorityClients.js.map +1 -1
  298. package/dist/service/EdgeRuntime.d.ts +73 -0
  299. package/dist/service/EdgeRuntime.d.ts.map +1 -0
  300. package/dist/service/EdgeRuntime.js +209 -0
  301. package/dist/service/EdgeRuntime.js.map +1 -0
  302. package/dist/service/EscalationResolver.d.ts +82 -2
  303. package/dist/service/EscalationResolver.d.ts.map +1 -1
  304. package/dist/service/EscalationResolver.js +39 -3
  305. package/dist/service/EscalationResolver.js.map +1 -1
  306. package/dist/service/Requests.d.ts +28 -2
  307. package/dist/service/Requests.d.ts.map +1 -1
  308. package/dist/service/TrustedExecutorService.d.ts +71 -1
  309. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  310. package/dist/service/TrustedExecutorService.js +461 -27
  311. package/dist/service/TrustedExecutorService.js.map +1 -1
  312. package/dist/tcp/TcpWire.d.ts +18 -0
  313. package/dist/tcp/TcpWire.d.ts.map +1 -0
  314. package/dist/tcp/TcpWire.js +114 -0
  315. package/dist/tcp/TcpWire.js.map +1 -0
  316. package/dist/verify/VerifyAuditChain.d.ts +5 -0
  317. package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
  318. package/dist/verify/VerifyAuditChain.js +20 -4
  319. package/dist/verify/VerifyAuditChain.js.map +1 -1
  320. package/package.json +7 -3
@@ -0,0 +1,16 @@
1
+ /**
2
+ * No provenance, said out loud.
3
+ *
4
+ * The default everywhere AgentSafe runs outside a described runtime, and the
5
+ * reason nothing degrades into a guess: an intent it contributes to carries
6
+ * no `workload` key at all, so a policy that requires trusted provenance
7
+ * refuses on the signal's absence rather than matching a placeholder that
8
+ * claims there is none.
9
+ */
10
+ export class NoneProvenanceProvider {
11
+ id = "none";
12
+ describe() {
13
+ return null;
14
+ }
15
+ }
16
+ //# sourceMappingURL=NoneProvenanceProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NoneProvenanceProvider.js","sourceRoot":"","sources":["../../src/provenance/NoneProvenanceProvider.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACjB,EAAE,GAAG,MAAM,CAAC;IAErB,QAAQ;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
@@ -0,0 +1,94 @@
1
+ import type { WorkloadSignal, WorkloadTrustLevel } from "@decionis/agent-safe-pipeline";
2
+ /**
3
+ * What software proposed the action, as some runtime reported it.
4
+ *
5
+ * AgentSafe is not the authority for any of this. Docker, OCI tooling and the
6
+ * platform establish what is running; this package carries what they say so
7
+ * that a policy can reason about it and evidence can record it. It does not
8
+ * scan an image, generate an SBOM, verify a publisher or check a signature,
9
+ * and it must never appear to have done so.
10
+ *
11
+ * That is why every workload carries its own `provenance`: who said this, and
12
+ * how far that goes. A field with no trust source beside it is a claim
13
+ * wearing the costume of a fact.
14
+ *
15
+ * The contract is deliberately one method. A family is a file beside this
16
+ * one, the way an effect adapter is a directory beside `banking/`.
17
+ */
18
+ /**
19
+ * How far the report can be trusted, strictly ordered, weakest first.
20
+ *
21
+ * - `unverified` — nothing trustworthy was available. Recorded, never hidden.
22
+ * - `supplied` — something told us, and nothing checked it. An environment
23
+ * variable an operator's manifest set is this, however true it happens to
24
+ * be: the process cannot distinguish a digest its orchestrator injected
25
+ * from one a compromised entrypoint wrote.
26
+ * - `observed` — the runtime reported it through an interface that is not the
27
+ * workload's to write.
28
+ * - `verified` — a signature or attestation was checked.
29
+ *
30
+ * **AgentSafe emits nothing above `supplied` today, and that is deliberate.**
31
+ * `verified` is reserved for a provider that consumes a signal the platform
32
+ * itself attests. Claiming it without one would be exactly the fabrication
33
+ * this design exists to prevent: a policy reading
34
+ * `workload.provenance.trust_level == "verified"` must be reading a checked
35
+ * signature, not an environment variable with ambitions.
36
+ */
37
+ export declare const TRUST_ORDER: readonly WorkloadTrustLevel[];
38
+ /** What a provider reads. Never the network, never an undocumented API. */
39
+ export interface ProvenanceFacts {
40
+ readonly env: Readonly<Record<string, string | undefined>>;
41
+ }
42
+ export interface ProvenanceProvider {
43
+ /** Names the trust source this provider speaks for; it appears in `provenance.source`. */
44
+ readonly id: string;
45
+ /**
46
+ * What this provider can say about the running workload, or null when it
47
+ * can say nothing. Bounded, synchronous and side-effect free: a provider
48
+ * that had to reach something to answer would be a provenance authority,
49
+ * which is the thing this abstraction exists not to be.
50
+ */
51
+ describe(facts: ProvenanceFacts): WorkloadSignal | null;
52
+ }
53
+ /** The strongest level anything in this repository may report. See `TRUST_ORDER`. */
54
+ export declare const MAX_REPORTED_TRUST: WorkloadTrustLevel;
55
+ /**
56
+ * Holds a provider to the ceiling, by refusing rather than clamping.
57
+ *
58
+ * A silent downgrade would hide the bug: a provider reaching for `verified`
59
+ * has decided it checked something, and if it did not, that is a defect to
60
+ * fix and not a value to quietly weaken on its way to a policy.
61
+ */
62
+ export declare function assertReportable(level: WorkloadTrustLevel): WorkloadTrustLevel;
63
+ /**
64
+ * The variables an operator's own manifest declares about the artifact this
65
+ * process is. There is no interface that hands a container its own image
66
+ * digest — not the Docker API without a socket the gateway must not have, and
67
+ * not the Kubernetes downward API, which exposes pod fields and not the
68
+ * resolved image. So the orchestrator puts it here, and because the workload
69
+ * could in principle write the same variable, what is read here is `supplied`
70
+ * and never more.
71
+ */
72
+ export declare const WORKLOAD_ENVIRONMENT: {
73
+ readonly image: "AGENTSAFE_WORKLOAD_IMAGE";
74
+ readonly digest: "AGENTSAFE_WORKLOAD_DIGEST";
75
+ readonly publisher: "AGENTSAFE_WORKLOAD_PUBLISHER";
76
+ };
77
+ /**
78
+ * An OCI artifact as the declared variables describe it, or null when they
79
+ * describe nothing. A malformed value is dropped rather than carried: a
80
+ * digest that is not a digest would be a field a policy could match on by
81
+ * accident.
82
+ */
83
+ export declare function declaredWorkload(facts: ProvenanceFacts, runtime: string, source: string, trustLevel: WorkloadTrustLevel): WorkloadSignal | null;
84
+ /**
85
+ * The first provider with something to say, in the order given.
86
+ *
87
+ * Nothing is merged. A workload assembled from two sources would carry one
88
+ * `provenance` describing neither, and the trust level would belong to the
89
+ * wrong fields. Silence is the honest answer when no provider has one: the
90
+ * key is then absent from the intent, so a policy that requires provenance
91
+ * refuses on its absence rather than matching a placeholder.
92
+ */
93
+ export declare function resolveWorkload(providers: readonly ProvenanceProvider[], facts: ProvenanceFacts): WorkloadSignal | null;
94
+ //# sourceMappingURL=ProvenanceProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ProvenanceProvider.d.ts","sourceRoot":"","sources":["../../src/provenance/ProvenanceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExF;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,kBAAkB,EAKpD,CAAC;AAEF,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI,CAAC;CACzD;AAED,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,EAAE,kBAA+B,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAK9E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAYX;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,kBAAkB,GAC7B,cAAc,GAAG,IAAI,CAavB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,KAAK,EAAE,eAAe,GACrB,cAAc,GAAG,IAAI,CAMvB"}
@@ -0,0 +1,118 @@
1
+ /**
2
+ * What software proposed the action, as some runtime reported it.
3
+ *
4
+ * AgentSafe is not the authority for any of this. Docker, OCI tooling and the
5
+ * platform establish what is running; this package carries what they say so
6
+ * that a policy can reason about it and evidence can record it. It does not
7
+ * scan an image, generate an SBOM, verify a publisher or check a signature,
8
+ * and it must never appear to have done so.
9
+ *
10
+ * That is why every workload carries its own `provenance`: who said this, and
11
+ * how far that goes. A field with no trust source beside it is a claim
12
+ * wearing the costume of a fact.
13
+ *
14
+ * The contract is deliberately one method. A family is a file beside this
15
+ * one, the way an effect adapter is a directory beside `banking/`.
16
+ */
17
+ /**
18
+ * How far the report can be trusted, strictly ordered, weakest first.
19
+ *
20
+ * - `unverified` — nothing trustworthy was available. Recorded, never hidden.
21
+ * - `supplied` — something told us, and nothing checked it. An environment
22
+ * variable an operator's manifest set is this, however true it happens to
23
+ * be: the process cannot distinguish a digest its orchestrator injected
24
+ * from one a compromised entrypoint wrote.
25
+ * - `observed` — the runtime reported it through an interface that is not the
26
+ * workload's to write.
27
+ * - `verified` — a signature or attestation was checked.
28
+ *
29
+ * **AgentSafe emits nothing above `supplied` today, and that is deliberate.**
30
+ * `verified` is reserved for a provider that consumes a signal the platform
31
+ * itself attests. Claiming it without one would be exactly the fabrication
32
+ * this design exists to prevent: a policy reading
33
+ * `workload.provenance.trust_level == "verified"` must be reading a checked
34
+ * signature, not an environment variable with ambitions.
35
+ */
36
+ export const TRUST_ORDER = [
37
+ "unverified",
38
+ "supplied",
39
+ "observed",
40
+ "verified",
41
+ ];
42
+ /** The strongest level anything in this repository may report. See `TRUST_ORDER`. */
43
+ export const MAX_REPORTED_TRUST = "supplied";
44
+ /**
45
+ * Holds a provider to the ceiling, by refusing rather than clamping.
46
+ *
47
+ * A silent downgrade would hide the bug: a provider reaching for `verified`
48
+ * has decided it checked something, and if it did not, that is a defect to
49
+ * fix and not a value to quietly weaken on its way to a policy.
50
+ */
51
+ export function assertReportable(level) {
52
+ if (TRUST_ORDER.indexOf(level) > TRUST_ORDER.indexOf(MAX_REPORTED_TRUST)) {
53
+ throw new Error("WORKLOAD_TRUST_NOT_REPORTABLE");
54
+ }
55
+ return level;
56
+ }
57
+ /**
58
+ * The variables an operator's own manifest declares about the artifact this
59
+ * process is. There is no interface that hands a container its own image
60
+ * digest — not the Docker API without a socket the gateway must not have, and
61
+ * not the Kubernetes downward API, which exposes pod fields and not the
62
+ * resolved image. So the orchestrator puts it here, and because the workload
63
+ * could in principle write the same variable, what is read here is `supplied`
64
+ * and never more.
65
+ */
66
+ export const WORKLOAD_ENVIRONMENT = {
67
+ image: "AGENTSAFE_WORKLOAD_IMAGE",
68
+ digest: "AGENTSAFE_WORKLOAD_DIGEST",
69
+ publisher: "AGENTSAFE_WORKLOAD_PUBLISHER",
70
+ };
71
+ const IMAGE = /^[\w.:/@-]{1,500}$/;
72
+ const DIGEST = /^sha256:[0-9a-f]{64}$/;
73
+ const PUBLISHER = /^[\w .:/@-]{1,200}$/;
74
+ function match(value, pattern) {
75
+ if (value === undefined)
76
+ return undefined;
77
+ const trimmed = value.trim();
78
+ return pattern.test(trimmed) ? trimmed : undefined;
79
+ }
80
+ /**
81
+ * An OCI artifact as the declared variables describe it, or null when they
82
+ * describe nothing. A malformed value is dropped rather than carried: a
83
+ * digest that is not a digest would be a field a policy could match on by
84
+ * accident.
85
+ */
86
+ export function declaredWorkload(facts, runtime, source, trustLevel) {
87
+ const image = match(facts.env[WORKLOAD_ENVIRONMENT.image], IMAGE);
88
+ const digest = match(facts.env[WORKLOAD_ENVIRONMENT.digest], DIGEST);
89
+ const publisher = match(facts.env[WORKLOAD_ENVIRONMENT.publisher], PUBLISHER);
90
+ if (image === undefined && digest === undefined && publisher === undefined)
91
+ return null;
92
+ return {
93
+ runtime,
94
+ artifact_type: "oci",
95
+ ...(image === undefined ? {} : { image }),
96
+ ...(digest === undefined ? {} : { digest }),
97
+ ...(publisher === undefined ? {} : { publisher }),
98
+ provenance: { source, trust_level: assertReportable(trustLevel) },
99
+ };
100
+ }
101
+ /**
102
+ * The first provider with something to say, in the order given.
103
+ *
104
+ * Nothing is merged. A workload assembled from two sources would carry one
105
+ * `provenance` describing neither, and the trust level would belong to the
106
+ * wrong fields. Silence is the honest answer when no provider has one: the
107
+ * key is then absent from the intent, so a policy that requires provenance
108
+ * refuses on its absence rather than matching a placeholder.
109
+ */
110
+ export function resolveWorkload(providers, facts) {
111
+ for (const provider of providers) {
112
+ const described = provider.describe(facts);
113
+ if (described !== null)
114
+ return described;
115
+ }
116
+ return null;
117
+ }
118
+ //# sourceMappingURL=ProvenanceProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ProvenanceProvider.js","sourceRoot":"","sources":["../../src/provenance/ProvenanceProvider.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD,YAAY;IACZ,UAAU;IACV,UAAU;IACV,UAAU;CACX,CAAC;AAmBF,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAuB,UAAU,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,0BAA0B;IACjC,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,8BAA8B;CACjC,CAAC;AAEX,MAAM,KAAK,GAAG,oBAAoB,CAAC;AACnC,MAAM,MAAM,GAAG,uBAAuB,CAAC;AACvC,MAAM,SAAS,GAAG,qBAAqB,CAAC;AAExC,SAAS,KAAK,CAAC,KAAyB,EAAE,OAAe;IACvD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,OAAe,EACf,MAAc,EACd,UAA8B;IAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9E,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACxF,OAAO;QACL,OAAO;QACP,aAAa,EAAE,KAAK;QACpB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QACjD,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC,EAAE;KAClE,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAwC,EACxC,KAAsB;IAEtB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,18 @@
1
+ import type { WorkloadSignal } from "@decionis/agent-safe-pipeline";
2
+ import { type ProvenanceProvider } from "./ProvenanceProvider.js";
3
+ /**
4
+ * A workload an operator states in code, for a deployment no runtime
5
+ * describes: a systemd unit, a process on a host, a test.
6
+ *
7
+ * It is held to the same ceiling as everything else. An operator writing a
8
+ * digest into a configuration has supplied it, not verified it, and a
9
+ * provider that let a caller declare its own trust level would be the
10
+ * silent upgrade this design exists to prevent.
11
+ */
12
+ export declare class StaticProvenanceProvider implements ProvenanceProvider {
13
+ readonly id = "operator";
14
+ private readonly workload;
15
+ constructor(workload: Omit<WorkloadSignal, "provenance">);
16
+ describe(): WorkloadSignal;
17
+ }
18
+ //# sourceMappingURL=StaticProvenanceProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StaticProvenanceProvider.d.ts","sourceRoot":"","sources":["../../src/provenance/StaticProvenanceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,SAAgB,EAAE,cAAc;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAEvB,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IAOxD,QAAQ,IAAI,cAAc;CAGlC"}
@@ -0,0 +1,25 @@
1
+ import { WorkloadSignalSchema } from "@decionis/agent-safe-pipeline";
2
+ import { MAX_REPORTED_TRUST, assertReportable, } from "./ProvenanceProvider.js";
3
+ /**
4
+ * A workload an operator states in code, for a deployment no runtime
5
+ * describes: a systemd unit, a process on a host, a test.
6
+ *
7
+ * It is held to the same ceiling as everything else. An operator writing a
8
+ * digest into a configuration has supplied it, not verified it, and a
9
+ * provider that let a caller declare its own trust level would be the
10
+ * silent upgrade this design exists to prevent.
11
+ */
12
+ export class StaticProvenanceProvider {
13
+ id = "operator";
14
+ workload;
15
+ constructor(workload) {
16
+ this.workload = WorkloadSignalSchema.parse({
17
+ ...workload,
18
+ provenance: { source: this.id, trust_level: assertReportable(MAX_REPORTED_TRUST) },
19
+ });
20
+ }
21
+ describe() {
22
+ return this.workload;
23
+ }
24
+ }
25
+ //# sourceMappingURL=StaticProvenanceProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StaticProvenanceProvider.js","sourceRoot":"","sources":["../../src/provenance/StaticProvenanceProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,OAAO,wBAAwB;IACnB,EAAE,GAAG,UAAU,CAAC;IACf,QAAQ,CAAiB;IAE1C,YAAmB,QAA4C;QAC7D,IAAI,CAAC,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC;YACzC,GAAG,QAAQ;YACX,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,EAAE;SACnF,CAAC,CAAC;IACL,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}
@@ -1,13 +1,16 @@
1
- import { DecionisGate, SafeExecutor, ShadowPipeline, type ActionRegistry, type AuditRecorder, type AuthorizationVerifier, type PresenceApprovalClient } from "@decionis/agent-safe-pipeline";
1
+ import { DecionisGate, SafeExecutor, ShadowPipeline, type ActionRegistry, type AuditRecorder, type AuthorizationVerifier, type DecisionAuthority, type DispatchedAttempts, type PresenceApprovalClient } from "@decionis/agent-safe-pipeline";
2
2
  import type { EffectEvidenceRegister } from "../adapters/EffectEvidenceRegister.js";
3
3
  import type { ExecutorConfig } from "../config/ExecutorConfig.js";
4
4
  import type { FetchLike } from "../handlers/HandlerRegistration.js";
5
5
  import type { SecurityEvents } from "../incident/SecurityEvents.js";
6
6
  import type { SecretStore } from "../secrets/SecretStore.js";
7
+ import type { EdgeRuntime } from "./EdgeRuntime.js";
7
8
  import { EscalationResolver } from "./EscalationResolver.js";
8
9
  /** Everything that holds an authority or Presence credential, built together. */
9
10
  export interface AuthorityClientSet {
10
11
  readonly gate: DecionisGate;
12
+ /** What decides first: the gate itself, or the edge authority in front of it. */
13
+ readonly authority: DecisionAuthority;
11
14
  readonly verifier: AuthorizationVerifier;
12
15
  readonly executor: SafeExecutor;
13
16
  readonly escalation: EscalationResolver;
@@ -27,6 +30,10 @@ export interface AuthorityClientsOptions {
27
30
  readonly id: string;
28
31
  readonly version: string;
29
32
  };
33
+ /** The edge evaluator, when the configuration asks for it; it outlives every rebuild. */
34
+ readonly edge?: EdgeRuntime | null;
35
+ /** The executor's record of what it dispatched, which a caller's reconciliation is held against. */
36
+ readonly attempts?: DispatchedAttempts;
30
37
  }
31
38
  /**
32
39
  * The gate, the verifier, the executor around them, the escalation resolver
@@ -1 +1 @@
1
- {"version":3,"file":"AuthorityClients.d.ts","sourceRoot":"","sources":["../../src/service/AuthorityClients.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,YAAY,EACZ,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAWD;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAIR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH3C,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;gBAEd,OAAO,EAAE,uBAAuB;IAa7D,OAAO,IAAI,kBAAkB;IAI7B,KAAK,IAAI,IAAI;IAKpB,OAAO,CAAC,MAAM,CAAC,KAAK;CA4CrB"}
1
+ {"version":3,"file":"AuthorityClients.d.ts","sourceRoot":"","sources":["../../src/service/AuthorityClients.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAIZ,YAAY,EACZ,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAWD;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAIR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH3C,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;gBAEd,OAAO,EAAE,uBAAuB;IAa7D,OAAO,IAAI,kBAAkB;IAI7B,KAAK,IAAI,IAAI;IAKpB,OAAO,CAAC,MAAM,CAAC,KAAK;CAgFrB"}
@@ -1,4 +1,4 @@
1
- import { DecionisGate, DecionisGrantVerifier, SafeExecutor, ShadowPipeline, } from "@decionis/agent-safe-pipeline";
1
+ import { DecionisGate, DecionisGrantVerifier, EdgeDecisionAuthority, LocalAuthorizationVerifier, SafeExecutor, ShadowPipeline, } from "@decionis/agent-safe-pipeline";
2
2
  import { EffectAwareGrantVerifier } from "../adapters/EffectAwareGrantVerifier.js";
3
3
  import { EscalationResolver } from "./EscalationResolver.js";
4
4
  /**
@@ -57,26 +57,54 @@ export class AuthorityClients {
57
57
  const grantVerifier = new DecionisGrantVerifier(authority);
58
58
  // The verifier the executor runs finalizes with whatever the handler
59
59
  // observed; without an effect plane it is the grant verifier itself.
60
- const verifier = options.effects === undefined
60
+ const hostedVerifier = options.effects === undefined
61
61
  ? grantVerifier
62
62
  : new EffectAwareGrantVerifier({
63
63
  verifier: grantVerifier,
64
64
  register: options.effects,
65
65
  observer: options.observer ?? { id: "agentsafe", version: "0.1.0" },
66
66
  });
67
+ // With the edge evaluator, an intent is decided locally first and the
68
+ // gate is asked only for an escalation or when no local decision can be
69
+ // made; a local authorization is consumed here, a hosted one is claimed
70
+ // through the hosted verifier, and either way the intent runs once.
71
+ const edge = options.edge ?? null;
72
+ const decider = edge === null
73
+ ? gate
74
+ : new EdgeDecisionAuthority({
75
+ module: edge.module,
76
+ bundles: edge.bundles,
77
+ hosted: gate,
78
+ grants: edge.grants,
79
+ replay: edge.replay,
80
+ mode: config.mode,
81
+ onUnavailable: edge.onUnavailable,
82
+ clock: edge.clock,
83
+ record: (record) => edge.record(record),
84
+ });
85
+ const verifier = edge === null
86
+ ? hostedVerifier
87
+ : new LocalAuthorizationVerifier({
88
+ grants: edge.grants,
89
+ replay: edge.replay,
90
+ delegate: hostedVerifier,
91
+ clock: edge.clock,
92
+ record: (record) => edge.record(record),
93
+ });
67
94
  const presenceApiKey = config.escalation.mode === "DIRECT"
68
95
  ? secrets.get("PRESENCE_API_KEY").use((value) => value.toString("utf8"))
69
96
  : null;
70
97
  const escalation = new EscalationResolver(config.escalation, gate, audit, {
71
98
  ...(options.presence === undefined ? {} : { presence: options.presence }),
72
99
  ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
73
- }, presenceApiKey);
100
+ }, presenceApiKey, decider);
74
101
  return {
75
102
  gate,
103
+ authority: decider,
76
104
  verifier,
77
- executor: new SafeExecutor(registry, verifier, audit),
105
+ executor: new SafeExecutor(registry, verifier, audit, options.attempts === undefined ? undefined : { attempts: options.attempts }),
78
106
  escalation,
79
- shadow: config.mode === "SHADOW" ? new ShadowPipeline(gate, { audit }) : null,
107
+ shadow: config.mode === "SHADOW" ? new ShadowPipeline(decider, { audit }) : null,
80
108
  };
81
109
  }
82
110
  }
@@ -1 +1 @@
1
- {"version":3,"file":"AuthorityClients.js","sourceRoot":"","sources":["../../src/service/AuthorityClients.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,cAAc,GAKf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAMnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAwB7D;;;;;;GAMG;AACH,MAAM,QAAQ,GAA0B,CAAC,kBAAkB,CAAC,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IAIS;IAH5B,GAAG,CAAqB;IACf,WAAW,GAAmB,EAAE,CAAC;IAElD,YAAoC,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;QAClE,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzC,IAAI,CAAC,WAAW,CAAC,IAAI,CACnB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE;gBAClC,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAChD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAEM,KAAK;QACV,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,OAAgC;QACnD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QACrD,MAAM,SAAS,GAAG;YAChB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO;YACjC,kEAAkE;YAClE,uEAAuE;YACvE,MAAM,EAAE,GAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5F,qBAAqB,EAAE,MAAM,CAAC,SAAS,CAAC,qBAAqB;YAC7D,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;SACjE,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAC3D,qEAAqE;QACrE,qEAAqE;QACrE,MAAM,QAAQ,GACZ,OAAO,CAAC,OAAO,KAAK,SAAS;YAC3B,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,IAAI,wBAAwB,CAAC;gBAC3B,QAAQ,EAAE,aAAa;gBACvB,QAAQ,EAAE,OAAO,CAAC,OAAO;gBACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE;aACpE,CAAC,CAAC;QACT,MAAM,cAAc,GAClB,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,QAAQ;YACjC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxE,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,UAAU,GAAG,IAAI,kBAAkB,CACvC,MAAM,CAAC,UAAU,EACjB,IAAI,EACJ,KAAK,EACL;YACE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YACzE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;SACjE,EACD,cAAc,CACf,CAAC;QACF,OAAO;YACL,IAAI;YACJ,QAAQ;YACR,QAAQ,EAAE,IAAI,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;YACrD,UAAU;YACV,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;SAC9E,CAAC;IACJ,CAAC;CACF"}
1
+ {"version":3,"file":"AuthorityClients.js","sourceRoot":"","sources":["../../src/service/AuthorityClients.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,73 @@
1
+ import { EdgeBundleManager, EdgeModule, LocalGrants, type EdgeDecisionRecord, type LocalFinalizationRecord, type ReplayStore } from "@decionis/agent-safe-pipeline";
2
+ import type { HashChain } from "../audit/HashChain.js";
3
+ import type { LineWriter } from "../audit/LineAuditSink.js";
4
+ import type { ExecutorConfig } from "../config/ExecutorConfig.js";
5
+ import { EdgeLicence } from "../edge/EdgeLicence.js";
6
+ import { type LoadPg } from "../edge/EdgeReplay.js";
7
+ import { UsageMeter } from "../edge/UsageMeter.js";
8
+ import type { FetchLike } from "../handlers/HandlerRegistration.js";
9
+ import type { SecurityEvents } from "../incident/SecurityEvents.js";
10
+ import type { SecretStore } from "../secrets/SecretStore.js";
11
+ export interface EdgeRuntimeOptions {
12
+ readonly config: ExecutorConfig;
13
+ /** Where the replay store's connection string and the usage-report key are read from. */
14
+ readonly secrets: SecretStore;
15
+ /** The organisation's Decionis key, read at the moment of each bundle fetch. */
16
+ readonly apiKey: () => string;
17
+ /** The guarded fetch: a bundle comes from the authority's origin, and nowhere else. */
18
+ readonly fetch: FetchLike;
19
+ readonly events: SecurityEvents;
20
+ /** The executor's evidence chain, and the writer its audit lines go through. */
21
+ readonly chain: HashChain;
22
+ readonly write: LineWriter;
23
+ /** Loads the module; the configured file unless a test hands in its own. */
24
+ readonly loadModule?: (path: string) => EdgeModule;
25
+ /** Loads `pg` for the Postgres replay store; the installed package unless a test hands in its own. */
26
+ readonly loadPg?: LoadPg;
27
+ readonly clock?: () => number;
28
+ }
29
+ /**
30
+ * The long-lived half of the edge authority: the module, the bundle it holds,
31
+ * the local grants, the replay store, the usage meter and the licence check.
32
+ * It outlives a rebuild of the authority clients, so a rotated Presence
33
+ * credential neither reloads the module nor forgets which intents have run.
34
+ */
35
+ export declare class EdgeRuntime {
36
+ private readonly options;
37
+ readonly module: EdgeModule;
38
+ readonly bundles: EdgeBundleManager;
39
+ readonly grants: LocalGrants;
40
+ readonly replay: ReplayStore;
41
+ readonly usage: UsageMeter;
42
+ readonly licence: EdgeLicence;
43
+ readonly onUnavailable: "hosted" | "block";
44
+ readonly clock: () => number;
45
+ private readonly shared;
46
+ private timer;
47
+ private constructor();
48
+ /**
49
+ * The runtime the configuration asks for, or null for a hosted deployment.
50
+ * A module that cannot be read, is not WebAssembly, or is not ABI 3, and a
51
+ * usage-report key that is not an Ed25519 private key, are refusals to
52
+ * start that name the variable and the reason, never a deployment that
53
+ * quietly decides hosted instead.
54
+ */
55
+ static create(options: EdgeRuntimeOptions): EdgeRuntime | null;
56
+ /**
57
+ * Links one local decision, or a local attempt's outcome, on the evidence
58
+ * chain. A decision is counted as its line is written, with the sequence
59
+ * and hash that line carries, so the count is the chain's own.
60
+ */
61
+ record(record: EdgeDecisionRecord | LocalFinalizationRecord): void;
62
+ /**
63
+ * The replay store first: a shared store that cannot be reached is a
64
+ * refusal to start, since nothing could be run once. Then the first
65
+ * bundle fetch, the first usage report and licence check, and the hourly
66
+ * schedule for both and for removing lapsed claims.
67
+ */
68
+ start(): Promise<void>;
69
+ /** One round of housekeeping. Never throws, and touches no decision. */
70
+ tick(): Promise<void>;
71
+ stop(): void;
72
+ }
73
+ //# sourceMappingURL=EdgeRuntime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EdgeRuntime.d.ts","sourceRoot":"","sources":["../../src/service/EdgeRuntime.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,UAAU,EAGV,WAAW,EAGX,KAAK,kBAAkB,EAEvB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAiD,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEnG,OAAO,EAGL,UAAU,EAEX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;IACnD,sGAAsG;IACtG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAKD;;;;;GAKG;AACH,qBAAa,WAAW;IAapB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,SAAgB,MAAM,EAAE,UAAU,CAAC;IACnC,SAAgB,OAAO,EAAE,iBAAiB,CAAC;IAC3C,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,KAAK,EAAE,UAAU,CAAC;IAClC,SAAgB,OAAO,EAAE,WAAW,CAAC;IACrC,SAAgB,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClD,SAAgB,KAAK,EAAE,MAAM,MAAM,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,KAAK,CAA+C;IAE5D,OAAO;IAgFP;;;;;;OAMG;WACW,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,GAAG,IAAI;IAsCrE;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,uBAAuB,GAAG,IAAI;IAwBzE;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBnC,wEAAwE;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,IAAI,IAAI,IAAI;CAOpB"}