@decionis/agentsafe 0.2.5 → 0.4.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 (299) hide show
  1. package/README.md +264 -89
  2. package/dist/Cli.js +24 -0
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +10 -4
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +8 -2
  7. package/dist/Index.js.map +1 -1
  8. package/dist/TrustedExecutor.d.ts.map +1 -1
  9. package/dist/TrustedExecutor.js +2 -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/EffectAwareGrantVerifier.d.ts +5 -2
  19. package/dist/adapters/EffectAwareGrantVerifier.d.ts.map +1 -1
  20. package/dist/adapters/EffectAwareGrantVerifier.js +9 -0
  21. package/dist/adapters/EffectAwareGrantVerifier.js.map +1 -1
  22. package/dist/adapters/banking/BankingAction.d.ts +2 -2
  23. package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
  24. package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
  25. package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
  26. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
  27. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
  28. package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
  29. package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
  30. package/dist/adapters/cards/CardEffect.d.ts +52 -0
  31. package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
  32. package/dist/adapters/cards/CardEffect.js +117 -0
  33. package/dist/adapters/cards/CardEffect.js.map +1 -0
  34. package/dist/adapters/cards/CardHandlers.d.ts +15 -0
  35. package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
  36. package/dist/adapters/cards/CardHandlers.js +26 -0
  37. package/dist/adapters/cards/CardHandlers.js.map +1 -0
  38. package/dist/adapters/cards/CardHoldSeal.d.ts +29 -0
  39. package/dist/adapters/cards/CardHoldSeal.d.ts.map +1 -0
  40. package/dist/adapters/cards/CardHoldSeal.js +87 -0
  41. package/dist/adapters/cards/CardHoldSeal.js.map +1 -0
  42. package/dist/adapters/cards/CardHoldStore.d.ts +102 -0
  43. package/dist/adapters/cards/CardHoldStore.d.ts.map +1 -0
  44. package/dist/adapters/cards/CardHoldStore.js +9 -0
  45. package/dist/adapters/cards/CardHoldStore.js.map +1 -0
  46. package/dist/adapters/cards/CardHolds.d.ts +19 -0
  47. package/dist/adapters/cards/CardHolds.d.ts.map +1 -0
  48. package/dist/adapters/cards/CardHolds.js +57 -0
  49. package/dist/adapters/cards/CardHolds.js.map +1 -0
  50. package/dist/adapters/cards/CardPurchase.d.ts +61 -0
  51. package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
  52. package/dist/adapters/cards/CardPurchase.js +116 -0
  53. package/dist/adapters/cards/CardPurchase.js.map +1 -0
  54. package/dist/adapters/cards/HeldCardGrants.d.ts +69 -0
  55. package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
  56. package/dist/adapters/cards/HeldCardGrants.js +169 -0
  57. package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
  58. package/dist/adapters/cards/Pan.d.ts +17 -0
  59. package/dist/adapters/cards/Pan.d.ts.map +1 -0
  60. package/dist/adapters/cards/Pan.js +52 -0
  61. package/dist/adapters/cards/Pan.js.map +1 -0
  62. package/dist/adapters/cards/PostgresCardHolds.d.ts +95 -0
  63. package/dist/adapters/cards/PostgresCardHolds.d.ts.map +1 -0
  64. package/dist/adapters/cards/PostgresCardHolds.js +411 -0
  65. package/dist/adapters/cards/PostgresCardHolds.js.map +1 -0
  66. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
  67. package/dist/adapters/mcp/McpGuard.js +9 -4
  68. package/dist/adapters/mcp/McpGuard.js.map +1 -1
  69. package/dist/audit/HashChain.d.ts +8 -2
  70. package/dist/audit/HashChain.d.ts.map +1 -1
  71. package/dist/audit/HashChain.js +14 -2
  72. package/dist/audit/HashChain.js.map +1 -1
  73. package/dist/cli/Cards.d.ts +5 -0
  74. package/dist/cli/Cards.d.ts.map +1 -0
  75. package/dist/cli/Cards.js +48 -0
  76. package/dist/cli/Cards.js.map +1 -0
  77. package/dist/cli/Commands.d.ts +1 -1
  78. package/dist/cli/Commands.d.ts.map +1 -1
  79. package/dist/cli/Commands.js +5 -0
  80. package/dist/cli/Commands.js.map +1 -1
  81. package/dist/cli/Edge.d.ts +4 -0
  82. package/dist/cli/Edge.d.ts.map +1 -0
  83. package/dist/cli/Edge.js +250 -0
  84. package/dist/cli/Edge.js.map +1 -0
  85. package/dist/cli/Help.d.ts.map +1 -1
  86. package/dist/cli/Help.js +9 -0
  87. package/dist/cli/Help.js.map +1 -1
  88. package/dist/cli/Host.d.ts +36 -0
  89. package/dist/cli/Host.d.ts.map +1 -0
  90. package/dist/cli/Host.js +247 -0
  91. package/dist/cli/Host.js.map +1 -0
  92. package/dist/cli/TcpBrokerCli.d.ts +4 -0
  93. package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
  94. package/dist/cli/TcpBrokerCli.js +93 -0
  95. package/dist/cli/TcpBrokerCli.js.map +1 -0
  96. package/dist/cli/TcpClientCli.d.ts +16 -0
  97. package/dist/cli/TcpClientCli.d.ts.map +1 -0
  98. package/dist/cli/TcpClientCli.js +175 -0
  99. package/dist/cli/TcpClientCli.js.map +1 -0
  100. package/dist/config/ConfigKeys.d.ts +2 -2
  101. package/dist/config/ConfigKeys.d.ts.map +1 -1
  102. package/dist/config/ConfigKeys.js +31 -0
  103. package/dist/config/ConfigKeys.js.map +1 -1
  104. package/dist/config/ExecutorConfig.d.ts +115 -0
  105. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  106. package/dist/config/ExecutorConfig.js +212 -0
  107. package/dist/config/ExecutorConfig.js.map +1 -1
  108. package/dist/edge/EdgeLicence.d.ts +25 -0
  109. package/dist/edge/EdgeLicence.d.ts.map +1 -0
  110. package/dist/edge/EdgeLicence.js +42 -0
  111. package/dist/edge/EdgeLicence.js.map +1 -0
  112. package/dist/edge/EdgeReplay.d.ts +45 -0
  113. package/dist/edge/EdgeReplay.d.ts.map +1 -0
  114. package/dist/edge/EdgeReplay.js +69 -0
  115. package/dist/edge/EdgeReplay.js.map +1 -0
  116. package/dist/edge/Entitlement.d.ts +57 -0
  117. package/dist/edge/Entitlement.d.ts.map +1 -0
  118. package/dist/edge/Entitlement.js +139 -0
  119. package/dist/edge/Entitlement.js.map +1 -0
  120. package/dist/edge/EntitlementEvaluation.d.ts +66 -0
  121. package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
  122. package/dist/edge/EntitlementEvaluation.js +74 -0
  123. package/dist/edge/EntitlementEvaluation.js.map +1 -0
  124. package/dist/edge/UsageCount.d.ts +40 -0
  125. package/dist/edge/UsageCount.d.ts.map +1 -0
  126. package/dist/edge/UsageCount.js +140 -0
  127. package/dist/edge/UsageCount.js.map +1 -0
  128. package/dist/edge/UsageKeyRegistration.d.ts +34 -0
  129. package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
  130. package/dist/edge/UsageKeyRegistration.js +74 -0
  131. package/dist/edge/UsageKeyRegistration.js.map +1 -0
  132. package/dist/edge/UsageMeter.d.ts +89 -0
  133. package/dist/edge/UsageMeter.d.ts.map +1 -0
  134. package/dist/edge/UsageMeter.js +275 -0
  135. package/dist/edge/UsageMeter.js.map +1 -0
  136. package/dist/edge/UsagePeriod.d.ts +23 -0
  137. package/dist/edge/UsagePeriod.d.ts.map +1 -0
  138. package/dist/edge/UsagePeriod.js +31 -0
  139. package/dist/edge/UsagePeriod.js.map +1 -0
  140. package/dist/edge/UsageReport.d.ts +92 -0
  141. package/dist/edge/UsageReport.d.ts.map +1 -0
  142. package/dist/edge/UsageReport.js +153 -0
  143. package/dist/edge/UsageReport.js.map +1 -0
  144. package/dist/edge/UsageTally.d.ts +63 -0
  145. package/dist/edge/UsageTally.d.ts.map +1 -0
  146. package/dist/edge/UsageTally.js +89 -0
  147. package/dist/edge/UsageTally.js.map +1 -0
  148. package/dist/egress/EgressError.d.ts +7 -1
  149. package/dist/egress/EgressError.d.ts.map +1 -1
  150. package/dist/egress/EgressError.js.map +1 -1
  151. package/dist/egress/EgressPolicy.d.ts +16 -3
  152. package/dist/egress/EgressPolicy.d.ts.map +1 -1
  153. package/dist/egress/EgressPolicy.js +33 -3
  154. package/dist/egress/EgressPolicy.js.map +1 -1
  155. package/dist/egress/GuardedFetch.d.ts +38 -1
  156. package/dist/egress/GuardedFetch.d.ts.map +1 -1
  157. package/dist/egress/GuardedFetch.js +52 -7
  158. package/dist/egress/GuardedFetch.js.map +1 -1
  159. package/dist/egress/TcpClient.d.ts +103 -0
  160. package/dist/egress/TcpClient.d.ts.map +1 -0
  161. package/dist/egress/TcpClient.js +490 -0
  162. package/dist/egress/TcpClient.js.map +1 -0
  163. package/dist/egress/TcpControlClient.d.ts +49 -0
  164. package/dist/egress/TcpControlClient.d.ts.map +1 -0
  165. package/dist/egress/TcpControlClient.js +186 -0
  166. package/dist/egress/TcpControlClient.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 +190 -10
  171. package/dist/gateway/Gateway.d.ts.map +1 -1
  172. package/dist/gateway/Gateway.js +465 -62
  173. package/dist/gateway/Gateway.js.map +1 -1
  174. package/dist/gateway/GatewayConfig.d.ts +67 -0
  175. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  176. package/dist/gateway/GatewayConfig.js +149 -2
  177. package/dist/gateway/GatewayConfig.js.map +1 -1
  178. package/dist/gateway/InterceptedRequest.d.ts +9 -2
  179. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  180. package/dist/gateway/InterceptedRequest.js +41 -9
  181. package/dist/gateway/InterceptedRequest.js.map +1 -1
  182. package/dist/gateway/RateLimit.d.ts +29 -0
  183. package/dist/gateway/RateLimit.d.ts.map +1 -0
  184. package/dist/gateway/RateLimit.js +33 -0
  185. package/dist/gateway/RateLimit.js.map +1 -0
  186. package/dist/gateway/RefusalSampler.d.ts +28 -0
  187. package/dist/gateway/RefusalSampler.d.ts.map +1 -0
  188. package/dist/gateway/RefusalSampler.js +52 -0
  189. package/dist/gateway/RefusalSampler.js.map +1 -0
  190. package/dist/gateway/RouteTable.d.ts +3 -0
  191. package/dist/gateway/RouteTable.d.ts.map +1 -1
  192. package/dist/gateway/RouteTable.js +44 -7
  193. package/dist/gateway/RouteTable.js.map +1 -1
  194. package/dist/gateway/Upstream.d.ts +26 -0
  195. package/dist/gateway/Upstream.d.ts.map +1 -1
  196. package/dist/gateway/Upstream.js +41 -2
  197. package/dist/gateway/Upstream.js.map +1 -1
  198. package/dist/gateway/UpstreamProof.d.ts +235 -0
  199. package/dist/gateway/UpstreamProof.d.ts.map +1 -0
  200. package/dist/gateway/UpstreamProof.js +375 -0
  201. package/dist/gateway/UpstreamProof.js.map +1 -0
  202. package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
  203. package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
  204. package/dist/handlers/ForwardRequestHandler.js +12 -2
  205. package/dist/handlers/ForwardRequestHandler.js.map +1 -1
  206. package/dist/hosted/TenantHost.d.ts +180 -0
  207. package/dist/hosted/TenantHost.d.ts.map +1 -0
  208. package/dist/hosted/TenantHost.js +432 -0
  209. package/dist/hosted/TenantHost.js.map +1 -0
  210. package/dist/hosted/TenantRegistry.d.ts +73 -0
  211. package/dist/hosted/TenantRegistry.d.ts.map +1 -0
  212. package/dist/hosted/TenantRegistry.js +123 -0
  213. package/dist/hosted/TenantRegistry.js.map +1 -0
  214. package/dist/http/ExecutorHttpServer.d.ts +7 -0
  215. package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
  216. package/dist/http/ExecutorHttpServer.js +30 -5
  217. package/dist/http/ExecutorHttpServer.js.map +1 -1
  218. package/dist/http/GatewayHttpServer.d.ts +55 -3
  219. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  220. package/dist/http/GatewayHttpServer.js +157 -17
  221. package/dist/http/GatewayHttpServer.js.map +1 -1
  222. package/dist/http/RedirectServer.d.ts +26 -0
  223. package/dist/http/RedirectServer.d.ts.map +1 -0
  224. package/dist/http/RedirectServer.js +62 -0
  225. package/dist/http/RedirectServer.js.map +1 -0
  226. package/dist/http/Routes.d.ts +24 -0
  227. package/dist/http/Routes.d.ts.map +1 -1
  228. package/dist/http/Routes.js +28 -1
  229. package/dist/http/Routes.js.map +1 -1
  230. package/dist/http/TcpBroker.d.ts +57 -0
  231. package/dist/http/TcpBroker.d.ts.map +1 -0
  232. package/dist/http/TcpBroker.js +299 -0
  233. package/dist/http/TcpBroker.js.map +1 -0
  234. package/dist/http/TcpHostRelay.d.ts +24 -0
  235. package/dist/http/TcpHostRelay.d.ts.map +1 -0
  236. package/dist/http/TcpHostRelay.js +194 -0
  237. package/dist/http/TcpHostRelay.js.map +1 -0
  238. package/dist/http/TcpRelayStreams.d.ts +24 -0
  239. package/dist/http/TcpRelayStreams.d.ts.map +1 -0
  240. package/dist/http/TcpRelayStreams.js +128 -0
  241. package/dist/http/TcpRelayStreams.js.map +1 -0
  242. package/dist/http/TlsListener.d.ts +3 -1
  243. package/dist/http/TlsListener.d.ts.map +1 -1
  244. package/dist/http/TlsListener.js +7 -2
  245. package/dist/http/TlsListener.js.map +1 -1
  246. package/dist/identity/Authenticator.d.ts.map +1 -1
  247. package/dist/identity/Authenticator.js +5 -2
  248. package/dist/identity/Authenticator.js.map +1 -1
  249. package/dist/identity/PrincipalsFile.d.ts +5 -1
  250. package/dist/identity/PrincipalsFile.d.ts.map +1 -1
  251. package/dist/identity/PrincipalsFile.js +2 -0
  252. package/dist/identity/PrincipalsFile.js.map +1 -1
  253. package/dist/incident/Metrics.d.ts +2 -0
  254. package/dist/incident/Metrics.d.ts.map +1 -1
  255. package/dist/incident/Metrics.js +10 -0
  256. package/dist/incident/Metrics.js.map +1 -1
  257. package/dist/incident/SecurityEvents.d.ts +98 -0
  258. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  259. package/dist/incident/SecurityEvents.js +96 -2
  260. package/dist/incident/SecurityEvents.js.map +1 -1
  261. package/dist/journal/ExecutionJournal.d.ts +27 -0
  262. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  263. package/dist/journal/ExecutionJournal.js +28 -0
  264. package/dist/journal/ExecutionJournal.js.map +1 -1
  265. package/dist/journal/FileExecutionJournal.d.ts +2 -1
  266. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  267. package/dist/journal/FileExecutionJournal.js +4 -1
  268. package/dist/journal/FileExecutionJournal.js.map +1 -1
  269. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  270. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  271. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  272. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  273. package/dist/service/AuthorityClients.d.ts +8 -1
  274. package/dist/service/AuthorityClients.d.ts.map +1 -1
  275. package/dist/service/AuthorityClients.js +33 -5
  276. package/dist/service/AuthorityClients.js.map +1 -1
  277. package/dist/service/EdgeRuntime.d.ts +73 -0
  278. package/dist/service/EdgeRuntime.d.ts.map +1 -0
  279. package/dist/service/EdgeRuntime.js +209 -0
  280. package/dist/service/EdgeRuntime.js.map +1 -0
  281. package/dist/service/EscalationResolver.d.ts +109 -5
  282. package/dist/service/EscalationResolver.d.ts.map +1 -1
  283. package/dist/service/EscalationResolver.js +41 -3
  284. package/dist/service/EscalationResolver.js.map +1 -1
  285. package/dist/service/Requests.d.ts +45 -2
  286. package/dist/service/Requests.d.ts.map +1 -1
  287. package/dist/service/TrustedExecutorService.d.ts +144 -1
  288. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  289. package/dist/service/TrustedExecutorService.js +866 -37
  290. package/dist/service/TrustedExecutorService.js.map +1 -1
  291. package/dist/tcp/TcpWire.d.ts +18 -0
  292. package/dist/tcp/TcpWire.d.ts.map +1 -0
  293. package/dist/tcp/TcpWire.js +114 -0
  294. package/dist/tcp/TcpWire.js.map +1 -0
  295. package/dist/verify/VerifyAuditChain.d.ts +5 -0
  296. package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
  297. package/dist/verify/VerifyAuditChain.js +20 -4
  298. package/dist/verify/VerifyAuditChain.js.map +1 -1
  299. package/package.json +7 -3
@@ -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":"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"}
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"}
@@ -0,0 +1,209 @@
1
+ import { join } from "node:path";
2
+ import { EdgeBundleManager, EdgeModule, EdgeModuleError, FileBundleSource, LocalGrants, UrlBundleSource, } from "@decionis/agent-safe-pipeline";
3
+ import { EdgeLicence } from "../edge/EdgeLicence.js";
4
+ import { memoryReplay, postgresReplay } from "../edge/EdgeReplay.js";
5
+ import { FileEntitlementSource, UrlEntitlementSource } from "../edge/Entitlement.js";
6
+ import { FileUsageDelivery, UrlUsageDelivery, UsageMeter, } from "../edge/UsageMeter.js";
7
+ import { usageSigningKey } from "../edge/UsageReport.js";
8
+ import { RequestContext } from "../http/RequestContext.js";
9
+ /** How often usage reports are attempted, the entitlement re-read and lapsed claims removed. */
10
+ const TICK_MS = 3_600_000;
11
+ /**
12
+ * The long-lived half of the edge authority: the module, the bundle it holds,
13
+ * the local grants, the replay store, the usage meter and the licence check.
14
+ * It outlives a rebuild of the authority clients, so a rotated Presence
15
+ * credential neither reloads the module nor forgets which intents have run.
16
+ */
17
+ export class EdgeRuntime {
18
+ options;
19
+ module;
20
+ bundles;
21
+ grants;
22
+ replay;
23
+ usage;
24
+ licence;
25
+ onUnavailable;
26
+ clock;
27
+ shared;
28
+ timer = null;
29
+ constructor(options, module, source, key) {
30
+ this.options = options;
31
+ const { config, events } = options;
32
+ const edge = config.edge;
33
+ if (edge === null)
34
+ throw new Error("EDGE_NOT_CONFIGURED");
35
+ this.module = module;
36
+ this.clock = options.clock ?? Date.now;
37
+ this.onUnavailable = edge.onUnavailable;
38
+ this.grants = new LocalGrants(this.clock);
39
+ this.shared =
40
+ edge.replay.store === "memory"
41
+ ? memoryReplay()
42
+ : postgresReplay({
43
+ databaseUrl: () => options.secrets
44
+ .get("EXECUTOR_EDGE_REPLAY_DATABASE_URL")
45
+ .use((value) => value.toString("utf8").trim()),
46
+ namespace: edge.orgId,
47
+ table: edge.replay.table,
48
+ clock: this.clock,
49
+ ...(options.loadPg === undefined ? {} : { load: options.loadPg }),
50
+ });
51
+ this.replay = this.shared.store;
52
+ this.bundles = new EdgeBundleManager({
53
+ module,
54
+ source,
55
+ orgId: edge.orgId,
56
+ refreshSeconds: edge.refreshSeconds,
57
+ clock: this.clock,
58
+ onEvent: (event) => events.emit(event),
59
+ });
60
+ const url = edge.bundle.source === "url";
61
+ const delivery = url
62
+ ? new UrlUsageDelivery({
63
+ baseUrl: config.authority.baseUrl,
64
+ apiKey: options.apiKey,
65
+ fetch: options.fetch,
66
+ })
67
+ : edge.usage.reportDir === null
68
+ ? null
69
+ : new FileUsageDelivery(edge.usage.reportDir);
70
+ this.usage = new UsageMeter({
71
+ orgId: edge.orgId,
72
+ chain: options.chain,
73
+ installationId: edge.usage.installationId,
74
+ stateDir: config.evidence.journalDir === null ? null : join(config.evidence.journalDir, "edge"),
75
+ checkpointLines: config.evidence.checkpointLines,
76
+ events,
77
+ key,
78
+ delivery,
79
+ clock: this.clock,
80
+ });
81
+ this.licence = new EdgeLicence({
82
+ source: url
83
+ ? new UrlEntitlementSource({
84
+ baseUrl: config.authority.baseUrl,
85
+ apiKey: options.apiKey,
86
+ fetch: options.fetch,
87
+ })
88
+ : new FileEntitlementSource(edge.entitlement.file, edge.entitlement.jwksFile),
89
+ meter: this.usage,
90
+ orgId: edge.orgId,
91
+ events,
92
+ clock: this.clock,
93
+ });
94
+ if (key !== null) {
95
+ // The kid an operator registers as a `usage_report` provider key.
96
+ events.emit({
97
+ event: "EDGE_USAGE_KEY_LOADED",
98
+ kid: key().kid,
99
+ installation_id: this.usage.installationId,
100
+ });
101
+ }
102
+ }
103
+ /**
104
+ * The runtime the configuration asks for, or null for a hosted deployment.
105
+ * A module that cannot be read, is not WebAssembly, or is not ABI 3, and a
106
+ * usage-report key that is not an Ed25519 private key, are refusals to
107
+ * start that name the variable and the reason, never a deployment that
108
+ * quietly decides hosted instead.
109
+ */
110
+ static create(options) {
111
+ const edge = options.config.edge;
112
+ if (edge === null)
113
+ return null;
114
+ let module;
115
+ try {
116
+ module = (options.loadModule ?? EdgeModule.fromFile)(edge.wasmPath);
117
+ }
118
+ catch (error) {
119
+ const code = error instanceof EdgeModuleError ? error.code : "EDGE_MODULE_INVALID";
120
+ throw new Error(`CONFIG_INVALID: EXECUTOR_EDGE_WASM_PATH (${code})`);
121
+ }
122
+ let key = null;
123
+ if (edge.usage.signing) {
124
+ // Read at each use, so a rotated key file is followed; checked once here.
125
+ key = () => usageSigningKey(options.secrets
126
+ .get("EXECUTOR_EDGE_USAGE_SIGNING_KEY")
127
+ .use((value) => value.toString("utf8")), edge.usage.keyId);
128
+ try {
129
+ key();
130
+ }
131
+ catch {
132
+ throw new Error("CONFIG_INVALID: EXECUTOR_EDGE_USAGE_SIGNING_KEY (not an Ed25519 key)");
133
+ }
134
+ }
135
+ const source = edge.bundle.source === "file"
136
+ ? new FileBundleSource(edge.bundle.file)
137
+ : new UrlBundleSource({
138
+ baseUrl: options.config.authority.baseUrl,
139
+ apiKey: options.apiKey,
140
+ allowInsecureLoopback: options.config.authority.allowInsecureLoopback,
141
+ fetch: options.fetch,
142
+ });
143
+ return new EdgeRuntime(options, module, source, key);
144
+ }
145
+ /**
146
+ * Links one local decision, or a local attempt's outcome, on the evidence
147
+ * chain. A decision is counted as its line is written, with the sequence
148
+ * and hash that line carries, so the count is the chain's own.
149
+ */
150
+ record(record) {
151
+ // The record holds identifiers, codes and digests only; copied as JSON so
152
+ // the chain links exactly what the line will say.
153
+ const fields = JSON.parse(JSON.stringify(record));
154
+ const at = new Date(this.clock()).toISOString();
155
+ const chain = this.options.chain;
156
+ chain.link({ at, ...fields, caller_principal: RequestContext.current()?.principal ?? null }, (line) => {
157
+ this.options.write(line);
158
+ if (record.event !== "EDGE_DECISION")
159
+ return;
160
+ this.usage.observe({
161
+ at,
162
+ mode: record.mode,
163
+ verdict: record.verdict,
164
+ delegated: record.delegated,
165
+ jti: record.jti,
166
+ seq: chain.head.seq,
167
+ hash: chain.head.hash,
168
+ });
169
+ });
170
+ }
171
+ /**
172
+ * The replay store first: a shared store that cannot be reached is a
173
+ * refusal to start, since nothing could be run once. Then the first
174
+ * bundle fetch, the first usage report and licence check, and the hourly
175
+ * schedule for both and for removing lapsed claims.
176
+ */
177
+ async start() {
178
+ try {
179
+ await this.shared.ready();
180
+ }
181
+ catch (error) {
182
+ const code = error instanceof Error && error.message === "REPLAY_DRIVER_MISSING"
183
+ ? "REPLAY_DRIVER_MISSING"
184
+ : "REPLAY_STORE_UNAVAILABLE";
185
+ throw new Error(`CONFIG_INVALID: EXECUTOR_EDGE_REPLAY_DATABASE_URL (${code})`);
186
+ }
187
+ await this.bundles.start();
188
+ await this.tick();
189
+ this.timer = setInterval(() => void this.tick(), TICK_MS);
190
+ this.timer.unref();
191
+ }
192
+ /** One round of housekeeping. Never throws, and touches no decision. */
193
+ async tick() {
194
+ await this.usage.report();
195
+ await this.licence.check();
196
+ await this.shared.cleanup().catch(() => {
197
+ this.options.events.emit({ event: "EDGE_REPLAY_CLEANUP_FAILED" });
198
+ });
199
+ }
200
+ stop() {
201
+ if (this.timer !== null)
202
+ clearInterval(this.timer);
203
+ this.timer = null;
204
+ this.bundles.stop();
205
+ this.usage.stop();
206
+ void this.shared.close().catch(() => undefined);
207
+ }
208
+ }
209
+ //# sourceMappingURL=EdgeRuntime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EdgeRuntime.js","sourceRoot":"","sources":["../../src/service/EdgeRuntime.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import { z } from "zod";
2
- import { type AuditRecorder, type CapturedIntent, type DecionisGate, type GateDecision, type PresenceApprovalClient } from "@decionis/agent-safe-pipeline";
2
+ import { type AuditRecorder, type CapturedIntent, type DecionisGate, type DecisionAuthority, type DecisionGate, type PresenceApprovalClient } from "@decionis/agent-safe-pipeline";
3
3
  import type { EscalationConfig } from "../config/ExecutorConfig.js";
4
4
  import type { FetchLike } from "../handlers/HandlerRegistration.js";
5
5
  /**
@@ -45,13 +45,98 @@ export declare const EscalationHandoffSchema: z.ZodDiscriminatedUnion<[z.ZodObje
45
45
  }, z.core.$strict>;
46
46
  }, z.core.$strict>], "mode">;
47
47
  export type EscalationHandoff = z.infer<typeof EscalationHandoffSchema>;
48
+ /**
49
+ * A presence provider's attestation presented for an open escalation: the
50
+ * exact intent, and the compact JWS the provider signed over it (a
51
+ * cardholder's tap, for instance). It is evidence for a fresh evaluation,
52
+ * never authority; this process shapes and bounds it, sends it to the
53
+ * authority, which verifies it, and keeps nothing of it.
54
+ */
55
+ export declare const AttestationResumeSchema: z.ZodObject<{
56
+ mode: z.ZodLiteral<"ATTESTATION">;
57
+ intent: z.ZodRecord<z.ZodString, z.ZodUnknown>;
58
+ attestation: z.ZodString;
59
+ requirement: z.ZodOptional<z.ZodUnknown>;
60
+ }, z.core.$strict>;
61
+ /** What `/v1/escalations` accepts: a handoff it was given, or an attestation for the intent. */
62
+ export declare const EscalationResumeSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
63
+ mode: z.ZodLiteral<"DIRECT">;
64
+ intent: z.ZodRecord<z.ZodString, z.ZodUnknown>;
65
+ request_id: z.ZodString;
66
+ approval_url: z.ZodNullable<z.ZodString>;
67
+ expires_at: z.ZodNullable<z.ZodString>;
68
+ }, z.core.$strict>, z.ZodObject<{
69
+ mode: z.ZodLiteral<"MANAGED">;
70
+ intent: z.ZodRecord<z.ZodString, z.ZodUnknown>;
71
+ escalation: z.ZodObject<{
72
+ escalationId: z.ZodString;
73
+ intentId: z.ZodString;
74
+ status: z.ZodEnum<{
75
+ FAILED: "FAILED";
76
+ PENDING_PRESENCE: "PENDING_PRESENCE";
77
+ PRESENCE_REQUESTED: "PRESENCE_REQUESTED";
78
+ AWAITING_APPROVER: "AWAITING_APPROVER";
79
+ PRESENCE_VERIFIED: "PRESENCE_VERIFIED";
80
+ REAUTHORIZING: "REAUTHORIZING";
81
+ GRANT_READY: "GRANT_READY";
82
+ EXPIRED: "EXPIRED";
83
+ REJECTED: "REJECTED";
84
+ BLOCKED: "BLOCKED";
85
+ CANCELLED: "CANCELLED";
86
+ }>;
87
+ outcome: z.ZodEnum<{
88
+ ALLOW: "ALLOW";
89
+ BLOCK: "BLOCK";
90
+ ESCALATE_PENDING: "ESCALATE_PENDING";
91
+ ERROR: "ERROR";
92
+ }>;
93
+ expiresAt: z.ZodString;
94
+ reasonCodes: z.ZodReadonly<z.ZodArray<z.ZodString>>;
95
+ }, z.core.$strict>;
96
+ }, z.core.$strict>], "mode">, z.ZodObject<{
97
+ mode: z.ZodLiteral<"ATTESTATION">;
98
+ intent: z.ZodRecord<z.ZodString, z.ZodUnknown>;
99
+ attestation: z.ZodString;
100
+ requirement: z.ZodOptional<z.ZodUnknown>;
101
+ }, z.core.$strict>]>;
102
+ export type EscalationResume = z.infer<typeof EscalationResumeSchema>;
103
+ /**
104
+ * Where the authority sent the hold, as its decision carried it: the policy's
105
+ * selector (kind and role, never a person) and who proves the person, by
106
+ * which method. A third-party provider here (`koard`, method `CARD_TAP`)
107
+ * means that provider's attestation alone resumes the hold; `decionis` means
108
+ * Decionis Presence. Routing for whoever asks the person, never authority.
109
+ */
110
+ export interface AttestationRequirement {
111
+ readonly requirement_id: string | null;
112
+ readonly expires_at: string;
113
+ readonly selector: {
114
+ readonly kind: "ROLE" | "PRINCIPAL";
115
+ readonly role_id?: string;
116
+ } | null;
117
+ readonly verification: {
118
+ readonly provider: string;
119
+ readonly methods: readonly string[];
120
+ readonly level: "STANDARD" | "HIGH_CONFIDENCE";
121
+ } | null;
122
+ }
123
+ /**
124
+ * What the caller is handed when an escalation can be resumed with an
125
+ * attestation and nothing else: the exact intent, to present back with it,
126
+ * and where the authority sent the hold when it said.
127
+ */
128
+ export interface AttestationHandoff {
129
+ readonly mode: "ATTESTATION";
130
+ readonly intent: Record<string, unknown>;
131
+ readonly requirement: AttestationRequirement | null;
132
+ }
48
133
  type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
49
134
  /** The handoff without the intent: what a mode knows, and what is echoed while pending. */
50
135
  export type EscalationState = DistributiveOmit<EscalationHandoff, "intent">;
51
136
  /** One step of a resumption: either a decision to run, or a state to report. */
52
137
  export type EscalationResolution = {
53
138
  readonly kind: "DECISION";
54
- readonly decision: GateDecision;
139
+ readonly decision: DecisionGate;
55
140
  } | {
56
141
  readonly kind: "PENDING";
57
142
  readonly handoff: EscalationState;
@@ -75,19 +160,38 @@ export interface EscalationDependencies {
75
160
  export declare class EscalationResolver {
76
161
  private readonly config;
77
162
  private readonly gate;
163
+ /**
164
+ * What makes the first decision: the gate, unless an edge authority
165
+ * decides in front of it. Resumption is always the gate's: a ceremony's
166
+ * status and the re-evaluation with its receipt are hosted.
167
+ */
168
+ private readonly first;
78
169
  private readonly coordinator;
79
170
  private readonly presence;
80
171
  constructor(config: EscalationConfig, gate: DecionisGate, audit: AuditRecorder, dependencies?: EscalationDependencies,
81
172
  /** The Presence credential for `DIRECT`, read from its handle by the caller for this build. */
82
- presenceApiKey?: string | null);
173
+ presenceApiKey?: string | null,
174
+ /**
175
+ * What makes the first decision: the gate, unless an edge authority
176
+ * decides in front of it. Resumption is always the gate's: a ceremony's
177
+ * status and the re-evaluation with its receipt are hosted.
178
+ */
179
+ first?: DecisionAuthority);
83
180
  get mode(): EscalationConfig["mode"];
84
181
  /** The first evaluation: in managed mode it also asks the authority to orchestrate. */
85
- evaluate(captured: CapturedIntent): Promise<GateDecision>;
182
+ evaluate(captured: CapturedIntent): Promise<DecisionGate>;
86
183
  /**
87
184
  * What the caller is handed after an `ESCALATE`. In direct mode this opens
88
185
  * the Presence request, bound to the intent hash the person will see.
89
186
  */
90
- handoff(captured: CapturedIntent, decision: GateDecision): Promise<EscalationState | null>;
187
+ handoff(captured: CapturedIntent, decision: DecisionGate): Promise<EscalationState | null>;
188
+ /**
189
+ * A fresh evaluation of the same intent with a presence attestation as the
190
+ * approval evidence. Whatever the escalation shape, this asks for no
191
+ * orchestration: the authority verifies the attestation against the
192
+ * intent hash and decides, and a refusal is a fail-closed `BLOCK`.
193
+ */
194
+ attest(captured: CapturedIntent, attestation: string): Promise<DecisionGate>;
91
195
  /** One bounded lookup, then either a fresh decision or the state to report. */
92
196
  resume(captured: CapturedIntent, handoff: EscalationHandoff): Promise<EscalationResolution>;
93
197
  private resumeManaged;
@@ -1 +1 @@
1
- {"version":3,"file":"EscalationResolver.d.ts","sourceRoot":"","sources":["../../src/service/EscalationResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAIpE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAgClC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAEzF,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAE5E,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GAC9D;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;gBAGtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,YAAY,EACnC,KAAK,EAAE,aAAa,EACpB,YAAY,GAAE,sBAA2B;IACzC,+FAA+F;IAC/F,cAAc,GAAE,MAAM,GAAG,IAAW;IA4BtC,IAAW,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAE1C;IAED,uFAAuF;IAC1E,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBtE;;;OAGG;IACU,OAAO,CAClB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAsBlC,+EAA+E;IAClE,MAAM,CACjB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,oBAAoB,CAAC;YAQlB,aAAa;YA8Bb,YAAY;CAkC3B"}
1
+ {"version":3,"file":"EscalationResolver.d.ts","sourceRoot":"","sources":["../../src/service/EscalationResolver.ts"],"names":[],"mappings":"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"}
@@ -42,6 +42,25 @@ export const EscalationHandoffSchema = z.discriminatedUnion("mode", [
42
42
  }),
43
43
  }),
44
44
  ]);
45
+ /**
46
+ * A presence provider's attestation presented for an open escalation: the
47
+ * exact intent, and the compact JWS the provider signed over it (a
48
+ * cardholder's tap, for instance). It is evidence for a fresh evaluation,
49
+ * never authority; this process shapes and bounds it, sends it to the
50
+ * authority, which verifies it, and keeps nothing of it.
51
+ */
52
+ export const AttestationResumeSchema = z.strictObject({
53
+ mode: z.literal("ATTESTATION"),
54
+ intent: z.record(z.string(), z.unknown()),
55
+ attestation: z
56
+ .string()
57
+ .max(20_000)
58
+ .regex(/^[\w-]+\.[\w-]+\.[\w-]+$/),
59
+ /** The handoff's routing, echoed by a caller that presents the handoff whole; never read. */
60
+ requirement: z.unknown().optional(),
61
+ });
62
+ /** What `/v1/escalations` accepts: a handoff it was given, or an attestation for the intent. */
63
+ export const EscalationResumeSchema = z.union([EscalationHandoffSchema, AttestationResumeSchema]);
45
64
  /**
46
65
  * Resolves an `ESCALATE` in the shape the adopter configured. Both shapes
47
66
  * are stateless on this side: the handoff the caller presents is validated
@@ -51,13 +70,21 @@ export const EscalationHandoffSchema = z.discriminatedUnion("mode", [
51
70
  export class EscalationResolver {
52
71
  config;
53
72
  gate;
73
+ first;
54
74
  coordinator;
55
75
  presence;
56
76
  constructor(config, gate, audit, dependencies = {},
57
77
  /** The Presence credential for `DIRECT`, read from its handle by the caller for this build. */
58
- presenceApiKey = null) {
78
+ presenceApiKey = null,
79
+ /**
80
+ * What makes the first decision: the gate, unless an edge authority
81
+ * decides in front of it. Resumption is always the gate's: a ceremony's
82
+ * status and the re-evaluation with its receipt are hosted.
83
+ */
84
+ first = gate) {
59
85
  this.config = config;
60
86
  this.gate = gate;
87
+ this.first = first;
61
88
  if (config.mode !== "DIRECT") {
62
89
  this.coordinator = null;
63
90
  this.presence = null;
@@ -81,8 +108,8 @@ export class EscalationResolver {
81
108
  /** The first evaluation: in managed mode it also asks the authority to orchestrate. */
82
109
  async evaluate(captured) {
83
110
  if (this.config.mode !== "MANAGED")
84
- return await this.gate.evaluate(captured);
85
- return await this.gate.evaluate(captured, undefined, {
111
+ return await this.first.evaluate(captured);
112
+ return await this.first.evaluate(captured, undefined, {
86
113
  escalation: {
87
114
  mode: "MANAGED",
88
115
  approver: {
@@ -124,6 +151,17 @@ export class EscalationResolver {
124
151
  expires_at: result.expires_at ?? null,
125
152
  };
126
153
  }
154
+ /**
155
+ * A fresh evaluation of the same intent with a presence attestation as the
156
+ * approval evidence. Whatever the escalation shape, this asks for no
157
+ * orchestration: the authority verifies the attestation against the
158
+ * intent hash and decides, and a refusal is a fail-closed `BLOCK`.
159
+ */
160
+ async attest(captured, attestation) {
161
+ return await this.gate.evaluate(captured, {
162
+ humanApproval: { provider: "attestation", attestation },
163
+ });
164
+ }
127
165
  /** One bounded lookup, then either a fresh decision or the state to report. */
128
166
  async resume(captured, handoff) {
129
167
  if (handoff.mode !== this.config.mode) {