@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,89 @@
1
+ import type { HashChain } from "../audit/HashChain.js";
2
+ import type { FetchLike } from "../handlers/HandlerRegistration.js";
3
+ import type { SecurityEvents } from "../incident/SecurityEvents.js";
4
+ import { type UsageSigningKey } from "./UsageReport.js";
5
+ import { type UsageLine } from "./UsageTally.js";
6
+ /** Where a signed report goes: Decionis, or a directory an operator uploads from. */
7
+ export interface UsageDelivery {
8
+ readonly kind: "url" | "file";
9
+ /** `DELIVERED`, or a code saying why not; never throws. */
10
+ deliver(period: string, installationId: string, report: string): Promise<string>;
11
+ }
12
+ /**
13
+ * `POST /v1/edge/usage-reports` (`{"report": "<compact JWS>"}`) with the
14
+ * organisation's key. A `USAGE_REPORT_DUPLICATE` conflict means Decionis
15
+ * already holds this period's report at the same or a later chain position,
16
+ * so the report is delivered; any other refusal is returned by its code.
17
+ */
18
+ export declare class UrlUsageDelivery implements UsageDelivery {
19
+ private readonly options;
20
+ readonly kind = "url";
21
+ constructor(options: {
22
+ readonly baseUrl: string;
23
+ readonly apiKey: () => string;
24
+ readonly fetch: FetchLike;
25
+ });
26
+ deliver(_period: string, _installation: string, report: string): Promise<string>;
27
+ }
28
+ /** The air-gapped form: `usage-<period>-<installation>.jws` in a directory, written atomically. */
29
+ export declare class FileUsageDelivery implements UsageDelivery {
30
+ private readonly directory;
31
+ readonly kind = "file";
32
+ constructor(directory: string);
33
+ deliver(period: string, installationId: string, report: string): Promise<string>;
34
+ }
35
+ export interface UsageMeterOptions {
36
+ readonly orgId: string;
37
+ readonly chain: HashChain;
38
+ /** The installation id the operator chose; generated and kept with the tally when null. */
39
+ readonly installationId: string | null;
40
+ /** Where the tally persists (`<journal>/edge`); in memory only when null. */
41
+ readonly stateDir: string | null;
42
+ /** How many evidence links between persisted tallies: the chain journal's cadence. */
43
+ readonly checkpointLines: number;
44
+ readonly events: SecurityEvents;
45
+ /** Reads the usage-report key; without one nothing is reported, and the licence check warns. */
46
+ readonly key: (() => UsageSigningKey) | null;
47
+ readonly delivery: UsageDelivery | null;
48
+ readonly clock: () => number;
49
+ }
50
+ /**
51
+ * The live count of this installation's edge decisions, and the monthly
52
+ * reports made from it. The tally is persisted with the evidence chain's
53
+ * head, at the journal's cadence and on stop, so it resumes exactly where
54
+ * the chain resumes; a tally whose head is not the chain's restored head
55
+ * belongs to a chain that is gone, and is dropped with a warning (the
56
+ * month can be recounted from the collected log with
57
+ * `agentsafe edge usage-report`).
58
+ */
59
+ export declare class UsageMeter {
60
+ private readonly options;
61
+ readonly installationId: string;
62
+ private readonly tally;
63
+ private readonly delivered;
64
+ private readonly since;
65
+ private readonly unsubscribe;
66
+ constructor(options: UsageMeterOptions);
67
+ /** Counts one `EDGE_DECISION` line, as it was linked. */
68
+ observe(line: UsageLine): void;
69
+ /** Governed actions this installation counted in the current month: decisions not delegated. */
70
+ governed(): number;
71
+ /** Whether a usage-report key is configured. */
72
+ get reporting(): boolean;
73
+ /** Completed periods since this installation began whose report has not been delivered. */
74
+ undelivered(): readonly string[];
75
+ /**
76
+ * Signs and delivers every undelivered completed period's report, oldest
77
+ * first. Never throws: a report that cannot be signed or delivered is an
78
+ * `EDGE_USAGE_REPORT_FAILED` line and is tried again on the next round.
79
+ */
80
+ report(): Promise<void>;
81
+ /** Stops following the chain and persists the tally once more. */
82
+ stop(): void;
83
+ private path;
84
+ private restore;
85
+ private persist;
86
+ /** The start of the oldest period a report is still made for. */
87
+ private windowStart;
88
+ }
89
+ //# sourceMappingURL=UsageMeter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageMeter.d.ts","sourceRoot":"","sources":["../../src/edge/UsageMeter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,EAAsC,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK7D,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClF;AAcD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IAIlD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,SAAgB,IAAI,SAAS;gBAGV,OAAO,EAAE;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;KAC3B;IAGU,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA8B9F;AAED,mGAAmG;AACnG,qBAAa,iBAAkB,YAAW,aAAa;IAGlC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAF7C,SAAgB,IAAI,UAAU;gBAEM,SAAS,EAAE,MAAM;IAExC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAY9F;AAyBD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sFAAsF;IACtF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,gGAAgG;IAChG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,eAAe,CAAC,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IAOF,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN3C,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAEL,OAAO,EAAE,iBAAiB;IAyB9D,yDAAyD;IAClD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAIrC,gGAAgG;IACzF,QAAQ,IAAI,MAAM;IAKzB,gDAAgD;IAChD,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,2FAA2F;IACpF,WAAW,IAAI,SAAS,MAAM,EAAE;IAUvC;;;;OAIG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CpC,kEAAkE;IAC3D,IAAI,IAAI,IAAI;IAKnB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,OAAO;IAyBf,iEAAiE;IACjE,OAAO,CAAC,WAAW;CAKpB"}
@@ -0,0 +1,275 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { z } from "zod";
5
+ import { withoutTrailingSlash } from "./Entitlement.js";
6
+ import { periodOf, previousPeriod, usagePeriod } from "./UsagePeriod.js";
7
+ import { signUsageReport, usageReportClaims } from "./UsageReport.js";
8
+ import { UsageTally } from "./UsageTally.js";
9
+ /** How many completed periods back a report is still made for. */
10
+ const LOOKBACK_PERIODS = 12;
11
+ /** The refusal code Decionis answered with, when it is one of the usage report's own. */
12
+ async function refusalOf(response) {
13
+ try {
14
+ const body = (await response.json());
15
+ return typeof body.error === "string" && /^USAGE_REPORT_[A-Z_]{1,50}$/.test(body.error)
16
+ ? body.error
17
+ : null;
18
+ }
19
+ catch {
20
+ return null;
21
+ }
22
+ }
23
+ /**
24
+ * `POST /v1/edge/usage-reports` (`{"report": "<compact JWS>"}`) with the
25
+ * organisation's key. A `USAGE_REPORT_DUPLICATE` conflict means Decionis
26
+ * already holds this period's report at the same or a later chain position,
27
+ * so the report is delivered; any other refusal is returned by its code.
28
+ */
29
+ export class UrlUsageDelivery {
30
+ options;
31
+ kind = "url";
32
+ constructor(options) {
33
+ this.options = options;
34
+ }
35
+ async deliver(_period, _installation, report) {
36
+ const controller = new AbortController();
37
+ const timeout = setTimeout(() => controller.abort(), 10_000);
38
+ try {
39
+ const response = await this.options.fetch(`${withoutTrailingSlash(this.options.baseUrl)}/v1/edge/usage-reports`, {
40
+ method: "POST",
41
+ headers: {
42
+ authorization: `Bearer ${this.options.apiKey()}`,
43
+ "content-type": "application/json",
44
+ accept: "application/json",
45
+ },
46
+ body: JSON.stringify({ report }),
47
+ signal: controller.signal,
48
+ });
49
+ if (response.ok) {
50
+ await response.body?.cancel().catch(() => undefined);
51
+ return "DELIVERED";
52
+ }
53
+ const refusal = await refusalOf(response);
54
+ if (refusal === "USAGE_REPORT_DUPLICATE")
55
+ return "DELIVERED";
56
+ return refusal ?? `USAGE_HTTP_${response.status}`;
57
+ }
58
+ catch {
59
+ return "USAGE_SEND_FAILED";
60
+ }
61
+ finally {
62
+ clearTimeout(timeout);
63
+ }
64
+ }
65
+ }
66
+ /** The air-gapped form: `usage-<period>-<installation>.jws` in a directory, written atomically. */
67
+ export class FileUsageDelivery {
68
+ directory;
69
+ kind = "file";
70
+ constructor(directory) {
71
+ this.directory = directory;
72
+ }
73
+ async deliver(period, installationId, report) {
74
+ const name = `usage-${period}-${installationId.replace(/[^\w.-]/g, "_")}.jws`;
75
+ const path = join(this.directory, name);
76
+ try {
77
+ mkdirSync(this.directory, { recursive: true, mode: 0o700 });
78
+ writeFileSync(`${path}.tmp`, `${report}\n`, { mode: 0o600 });
79
+ renameSync(`${path}.tmp`, path);
80
+ return "DELIVERED";
81
+ }
82
+ catch {
83
+ return "USAGE_WRITE_FAILED";
84
+ }
85
+ }
86
+ }
87
+ const PeriodUsageSchema = z.strictObject({
88
+ counts: z.strictObject({
89
+ by_mode: z.strictObject({ ENFORCEMENT: z.number(), SHADOW: z.number() }),
90
+ by_verdict: z.strictObject({ ALLOW: z.number(), ESCALATE: z.number(), BLOCK: z.number() }),
91
+ total: z.number(),
92
+ }),
93
+ delegated: z.number(),
94
+ first_seq: z.number().nullable(),
95
+ first_hash: z.string().nullable(),
96
+ last_seq: z.number().nullable(),
97
+ last_hash: z.string().nullable(),
98
+ bundles: z.array(z.string()),
99
+ });
100
+ const MeterStateSchema = z.strictObject({
101
+ version: z.literal(1),
102
+ installation_id: z.string().min(1).max(200),
103
+ since: z.number(),
104
+ head: z.strictObject({ seq: z.number(), hash: z.string() }),
105
+ periods: z.record(z.string(), PeriodUsageSchema),
106
+ delivered: z.array(z.string()),
107
+ });
108
+ /**
109
+ * The live count of this installation's edge decisions, and the monthly
110
+ * reports made from it. The tally is persisted with the evidence chain's
111
+ * head, at the journal's cadence and on stop, so it resumes exactly where
112
+ * the chain resumes; a tally whose head is not the chain's restored head
113
+ * belongs to a chain that is gone, and is dropped with a warning (the
114
+ * month can be recounted from the collected log with
115
+ * `agentsafe edge usage-report`).
116
+ */
117
+ export class UsageMeter {
118
+ options;
119
+ installationId;
120
+ tally;
121
+ delivered;
122
+ since;
123
+ unsubscribe;
124
+ constructor(options) {
125
+ this.options = options;
126
+ const restored = this.restore();
127
+ const head = options.chain.head;
128
+ const resumes = restored !== null &&
129
+ restored.head.seq === head.seq &&
130
+ restored.head.hash === head.hash &&
131
+ (options.installationId === null || options.installationId === restored.installation_id);
132
+ if (restored !== null && !resumes) {
133
+ options.events.emit({ event: "EDGE_USAGE_TALLY_RESET", head: head.seq });
134
+ }
135
+ this.installationId =
136
+ options.installationId ?? (resumes ? restored.installation_id : `inst_${randomUUID()}`);
137
+ this.tally = new UsageTally(resumes ? restored.periods : {});
138
+ this.delivered = new Set(resumes ? restored.delivered : []);
139
+ this.since = resumes ? restored.since : options.clock();
140
+ let links = 0;
141
+ this.unsubscribe = options.chain.onLink(() => {
142
+ links += 1;
143
+ if (links < options.checkpointLines)
144
+ return;
145
+ links = 0;
146
+ this.persist();
147
+ });
148
+ }
149
+ /** Counts one `EDGE_DECISION` line, as it was linked. */
150
+ observe(line) {
151
+ this.tally.add(line);
152
+ }
153
+ /** Governed actions this installation counted in the current month: decisions not delegated. */
154
+ governed() {
155
+ const usage = this.tally.usage(periodOf(this.options.clock()).period);
156
+ return usage.counts.total - usage.delegated;
157
+ }
158
+ /** Whether a usage-report key is configured. */
159
+ get reporting() {
160
+ return this.options.key !== null;
161
+ }
162
+ /** Completed periods since this installation began whose report has not been delivered. */
163
+ undelivered() {
164
+ const periods = [];
165
+ let period = previousPeriod(periodOf(this.options.clock()));
166
+ for (let back = 0; back < LOOKBACK_PERIODS && period.end > this.since; back += 1) {
167
+ if (!this.delivered.has(period.period))
168
+ periods.push(period.period);
169
+ period = previousPeriod(period);
170
+ }
171
+ return periods.reverse();
172
+ }
173
+ /**
174
+ * Signs and delivers every undelivered completed period's report, oldest
175
+ * first. Never throws: a report that cannot be signed or delivered is an
176
+ * `EDGE_USAGE_REPORT_FAILED` line and is tried again on the next round.
177
+ */
178
+ async report() {
179
+ const { delivery } = this.options;
180
+ const key = this.options.key;
181
+ if (key === null || delivery === null)
182
+ return;
183
+ for (const name of this.undelivered()) {
184
+ const period = usagePeriod(name);
185
+ let report;
186
+ try {
187
+ report = await signUsageReport(usageReportClaims({
188
+ installationId: this.installationId,
189
+ orgId: this.options.orgId,
190
+ period,
191
+ usage: this.tally.usage(name),
192
+ stream: this.options.chain.stream,
193
+ now: this.options.clock(),
194
+ }), key());
195
+ }
196
+ catch {
197
+ this.options.events.emit({
198
+ event: "EDGE_USAGE_REPORT_FAILED",
199
+ period: name,
200
+ code: "USAGE_SIGN_FAILED",
201
+ });
202
+ continue;
203
+ }
204
+ const code = await delivery.deliver(name, this.installationId, report);
205
+ if (code !== "DELIVERED") {
206
+ this.options.events.emit({ event: "EDGE_USAGE_REPORT_FAILED", period: name, code });
207
+ continue;
208
+ }
209
+ this.delivered.add(name);
210
+ this.options.events.emit({
211
+ event: "EDGE_USAGE_REPORTED",
212
+ period: name,
213
+ destination: delivery.kind,
214
+ total: this.tally.usage(name).counts.total,
215
+ });
216
+ this.tally.forget(name);
217
+ }
218
+ this.persist();
219
+ }
220
+ /** Stops following the chain and persists the tally once more. */
221
+ stop() {
222
+ this.unsubscribe();
223
+ this.persist();
224
+ }
225
+ path() {
226
+ return this.options.stateDir === null ? null : join(this.options.stateDir, "usage.json");
227
+ }
228
+ restore() {
229
+ const path = this.path();
230
+ if (path === null)
231
+ return null;
232
+ try {
233
+ const parsed = MeterStateSchema.safeParse(JSON.parse(readFileSync(path, "utf8")));
234
+ return parsed.success ? parsed.data : null;
235
+ }
236
+ catch {
237
+ return null;
238
+ }
239
+ }
240
+ persist() {
241
+ const path = this.path();
242
+ if (path === null || this.options.stateDir === null)
243
+ return;
244
+ // Only the window a report can still be made for is kept.
245
+ const windowStart = this.windowStart();
246
+ const old = (period) => usagePeriod(period).end <= windowStart;
247
+ for (const period of this.tally.counted())
248
+ if (old(period))
249
+ this.tally.forget(period);
250
+ const state = {
251
+ version: 1,
252
+ installation_id: this.installationId,
253
+ since: this.since,
254
+ head: { ...this.options.chain.head },
255
+ periods: { ...this.tally.snapshot() },
256
+ delivered: [...this.delivered].filter((period) => !old(period)),
257
+ };
258
+ try {
259
+ mkdirSync(this.options.stateDir, { recursive: true, mode: 0o700 });
260
+ writeFileSync(`${path}.tmp`, JSON.stringify(state), { mode: 0o600 });
261
+ renameSync(`${path}.tmp`, path);
262
+ }
263
+ catch {
264
+ this.options.events.emit({ event: "EDGE_USAGE_PERSIST_FAILED" });
265
+ }
266
+ }
267
+ /** The start of the oldest period a report is still made for. */
268
+ windowStart() {
269
+ let period = periodOf(this.options.clock());
270
+ for (let back = 0; back < LOOKBACK_PERIODS; back += 1)
271
+ period = previousPeriod(period);
272
+ return period.start;
273
+ }
274
+ }
275
+ //# sourceMappingURL=UsageMeter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageMeter.js","sourceRoot":"","sources":["../../src/edge/UsageMeter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * A usage period: one calendar month in UTC, written `YYYY-MM`. Its start is
3
+ * the first instant of the month and its end the first instant of the next,
4
+ * so a line belongs to exactly one period: `start <= at < end`.
5
+ */
6
+ export interface UsagePeriod {
7
+ readonly period: string;
8
+ /** Milliseconds since the epoch, inclusive. */
9
+ readonly start: number;
10
+ /** Milliseconds since the epoch, exclusive: the next period's start. */
11
+ readonly end: number;
12
+ }
13
+ /** The period `period` names, or null when it is not one. */
14
+ export declare function usagePeriod(period: string): UsagePeriod | null;
15
+ /** The period an instant falls in. */
16
+ export declare function periodOf(instant: number): UsagePeriod;
17
+ /** The period before `period`. */
18
+ export declare function previousPeriod(period: UsagePeriod): UsagePeriod;
19
+ /** Whether `instant` lies inside the period. */
20
+ export declare function inPeriod(period: UsagePeriod, instant: number): boolean;
21
+ /** When the report for `period` is due: `dueDays` days after it ends. */
22
+ export declare function reportDueAt(period: UsagePeriod, dueDays: number): number;
23
+ //# sourceMappingURL=UsagePeriod.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsagePeriod.d.ts","sourceRoot":"","sources":["../../src/edge/UsagePeriod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAMD,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAM9D;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAIrD;AAED,kCAAkC;AAClC,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE/D;AAED,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE"}
@@ -0,0 +1,31 @@
1
+ /** Years 2000 to 2999: `Date.UTC` reads a two-digit year as the 1900s, so none is accepted. */
2
+ const PERIOD = /^(2\d{3})-(0[1-9]|1[0-2])$/;
3
+ const DAY_MS = 86_400_000;
4
+ /** The period `period` names, or null when it is not one. */
5
+ export function usagePeriod(period) {
6
+ const match = PERIOD.exec(period);
7
+ if (match === null)
8
+ return null;
9
+ const year = Number(match[1]);
10
+ const month = Number(match[2]) - 1;
11
+ return { period, start: Date.UTC(year, month, 1), end: Date.UTC(year, month + 1, 1) };
12
+ }
13
+ /** The period an instant falls in. */
14
+ export function periodOf(instant) {
15
+ const date = new Date(instant);
16
+ const month = String(date.getUTCMonth() + 1).padStart(2, "0");
17
+ return usagePeriod(`${String(date.getUTCFullYear())}-${month}`);
18
+ }
19
+ /** The period before `period`. */
20
+ export function previousPeriod(period) {
21
+ return periodOf(period.start - 1);
22
+ }
23
+ /** Whether `instant` lies inside the period. */
24
+ export function inPeriod(period, instant) {
25
+ return instant >= period.start && instant < period.end;
26
+ }
27
+ /** When the report for `period` is due: `dueDays` days after it ends. */
28
+ export function reportDueAt(period, dueDays) {
29
+ return period.end + dueDays * DAY_MS;
30
+ }
31
+ //# sourceMappingURL=UsagePeriod.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsagePeriod.js","sourceRoot":"","sources":["../../src/edge/UsagePeriod.ts"],"names":[],"mappings":"AAaA,+FAA+F;AAC/F,MAAM,MAAM,GAAG,4BAA4B,CAAC;AAC5C,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,WAAW,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,KAAK,EAAE,CAAgB,CAAC;AACjF,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,QAAQ,CAAC,MAAmB,EAAE,OAAe;IAC3D,OAAO,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC;AACzD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,OAAe;IAC9D,OAAO,MAAM,CAAC,GAAG,GAAG,OAAO,GAAG,MAAM,CAAC;AACvC,CAAC"}
@@ -0,0 +1,92 @@
1
+ import { type KeyObject } from "node:crypto";
2
+ import { z } from "zod";
3
+ import { type UsagePeriod } from "./UsagePeriod.js";
4
+ import type { PeriodUsage } from "./UsageTally.js";
5
+ /** The JWS `typ` of a usage report, as Decionis ingestion checks it. */
6
+ export declare const USAGE_REPORT_TYPE = "decionis-edge-usage+jwt";
7
+ /** The claims of a usage report (Edge evaluator phase 4, section 3). */
8
+ export declare const UsageReportClaimsSchema: z.ZodObject<{
9
+ iss: z.ZodString;
10
+ aud: z.ZodString;
11
+ iat: z.ZodNumber;
12
+ jti: z.ZodString;
13
+ period: z.ZodString;
14
+ period_start: z.ZodString;
15
+ period_end: z.ZodString;
16
+ counts: z.ZodObject<{
17
+ by_mode: z.ZodObject<{
18
+ ENFORCEMENT: z.ZodNumber;
19
+ SHADOW: z.ZodNumber;
20
+ }, z.core.$strict>;
21
+ by_verdict: z.ZodObject<{
22
+ ALLOW: z.ZodNumber;
23
+ ESCALATE: z.ZodNumber;
24
+ BLOCK: z.ZodNumber;
25
+ }, z.core.$strict>;
26
+ total: z.ZodNumber;
27
+ }, z.core.$strict>;
28
+ delegated: z.ZodNumber;
29
+ chain: z.ZodObject<{
30
+ stream: z.ZodString;
31
+ first_seq: z.ZodNullable<z.ZodNumber>;
32
+ last_seq: z.ZodNullable<z.ZodNumber>;
33
+ first_hash: z.ZodNullable<z.ZodString>;
34
+ last_hash: z.ZodNullable<z.ZodString>;
35
+ }, z.core.$strict>;
36
+ bundles: z.ZodArray<z.ZodString>;
37
+ }, z.core.$strict>;
38
+ export type UsageReportClaims = z.infer<typeof UsageReportClaimsSchema>;
39
+ /** The usage report's claims for one period, as this installation counted it. */
40
+ export declare function usageReportClaims(input: {
41
+ readonly installationId: string;
42
+ readonly orgId: string;
43
+ readonly period: UsagePeriod;
44
+ readonly usage: PeriodUsage;
45
+ readonly stream: string;
46
+ readonly now: number;
47
+ /** The report's id; a fresh UUID unless a fixed vector names one. */
48
+ readonly jti?: string;
49
+ }): UsageReportClaims;
50
+ /** The usage the claims state, in the tally's shape, for a recount to compare with. */
51
+ export declare function claimedUsage(claims: UsageReportClaims): PeriodUsage & {
52
+ readonly stream: string;
53
+ };
54
+ /**
55
+ * Whether the claims agree with themselves: the period's bounds are the
56
+ * period's, each breakdown sums to the total, no more were delegated than
57
+ * decided, and the range is named exactly when something was counted.
58
+ */
59
+ export declare function consistentClaims(claims: UsageReportClaims): boolean;
60
+ /** An installation's usage-report key: Ed25519, with the `kid` it is registered under. */
61
+ export interface UsageSigningKey {
62
+ readonly kid: string;
63
+ readonly privateKey: KeyObject;
64
+ /** The public half, as `POST /v1/execution/provider-keys` takes it. */
65
+ readonly publicJwk: {
66
+ readonly kty: "OKP";
67
+ readonly crv: "Ed25519";
68
+ readonly x: string;
69
+ };
70
+ }
71
+ /**
72
+ * Reads a PKCS#8 PEM Ed25519 key. The `kid` is the one configured, or the
73
+ * key's RFC 7638 thumbprint, so the same key always has the same id.
74
+ */
75
+ export declare function usageSigningKey(pem: string, kid?: string | null): UsageSigningKey;
76
+ /** The compact JWS Decionis ingests: `alg` EdDSA, `typ` the usage report's, `kid` the key's. */
77
+ export declare function signUsageReport(claims: UsageReportClaims, key: UsageSigningKey): Promise<string>;
78
+ export type UsageReportRead = {
79
+ readonly ok: true;
80
+ readonly kid: string;
81
+ readonly claims: UsageReportClaims;
82
+ } | {
83
+ readonly ok: false;
84
+ readonly code: string;
85
+ };
86
+ /**
87
+ * Checks a usage report's signature against a public key and its claims
88
+ * against the schema and themselves. It does not recount: `verifyUsage`
89
+ * does that against the chain.
90
+ */
91
+ export declare function readUsageReport(token: string, publicJwk: Readonly<Record<string, unknown>>): Promise<UsageReportRead>;
92
+ //# sourceMappingURL=UsageReport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageReport.d.ts","sourceRoot":"","sources":["../../src/edge/UsageReport.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAM3D,wEAAwE;AACxE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwBlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,iBAAiB,CAqBpB;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWjG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAiBnE;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CASjF;AAED,gGAAgG;AAChG,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC3C,OAAO,CAAC,eAAe,CAAC,CAgC1B"}