@decionis/agentsafe 0.6.0 → 0.8.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 (288) hide show
  1. package/README.md +68 -20
  2. package/dist/Cli.js +30 -3
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +5 -3
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +3 -1
  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/acceptance/AcceptancePlan.d.ts +109 -0
  12. package/dist/acceptance/AcceptancePlan.d.ts.map +1 -0
  13. package/dist/acceptance/AcceptancePlan.js +128 -0
  14. package/dist/acceptance/AcceptancePlan.js.map +1 -0
  15. package/dist/acceptance/AcceptanceReport.d.ts +596 -0
  16. package/dist/acceptance/AcceptanceReport.d.ts.map +1 -0
  17. package/dist/acceptance/AcceptanceReport.js +361 -0
  18. package/dist/acceptance/AcceptanceReport.js.map +1 -0
  19. package/dist/acceptance/AcceptanceRun.d.ts +118 -0
  20. package/dist/acceptance/AcceptanceRun.d.ts.map +1 -0
  21. package/dist/acceptance/AcceptanceRun.js +419 -0
  22. package/dist/acceptance/AcceptanceRun.js.map +1 -0
  23. package/dist/acceptance/Coverage.d.ts +12 -0
  24. package/dist/acceptance/Coverage.d.ts.map +1 -0
  25. package/dist/acceptance/Coverage.js +48 -0
  26. package/dist/acceptance/Coverage.js.map +1 -0
  27. package/dist/acceptance/OutageDoubles.d.ts +34 -0
  28. package/dist/acceptance/OutageDoubles.d.ts.map +1 -0
  29. package/dist/acceptance/OutageDoubles.js +67 -0
  30. package/dist/acceptance/OutageDoubles.js.map +1 -0
  31. package/dist/acceptance/ZoneProbes.d.ts +368 -0
  32. package/dist/acceptance/ZoneProbes.d.ts.map +1 -0
  33. package/dist/acceptance/ZoneProbes.js +488 -0
  34. package/dist/acceptance/ZoneProbes.js.map +1 -0
  35. package/dist/adapters/JcsDigest.d.ts +6 -5
  36. package/dist/adapters/JcsDigest.d.ts.map +1 -1
  37. package/dist/adapters/JcsDigest.js +9 -8
  38. package/dist/adapters/JcsDigest.js.map +1 -1
  39. package/dist/adapters/mcp/McpGuard.d.ts +32 -3
  40. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
  41. package/dist/adapters/mcp/McpGuard.js +29 -5
  42. package/dist/adapters/mcp/McpGuard.js.map +1 -1
  43. package/dist/adapters/mcp/McpIntentBinder.d.ts +18 -3
  44. package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -1
  45. package/dist/adapters/mcp/McpIntentBinder.js +48 -1
  46. package/dist/adapters/mcp/McpIntentBinder.js.map +1 -1
  47. package/dist/adapters/mcp/McpInvocation.d.ts +9 -2
  48. package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -1
  49. package/dist/adapters/mcp/McpInvocation.js.map +1 -1
  50. package/dist/cli/Accept.d.ts +9 -0
  51. package/dist/cli/Accept.d.ts.map +1 -0
  52. package/dist/cli/Accept.js +209 -0
  53. package/dist/cli/Accept.js.map +1 -0
  54. package/dist/cli/Actions.d.ts +16 -0
  55. package/dist/cli/Actions.d.ts.map +1 -0
  56. package/dist/cli/Actions.js +194 -0
  57. package/dist/cli/Actions.js.map +1 -0
  58. package/dist/cli/Arguments.d.ts +4 -0
  59. package/dist/cli/Arguments.d.ts.map +1 -1
  60. package/dist/cli/Arguments.js +12 -3
  61. package/dist/cli/Arguments.js.map +1 -1
  62. package/dist/cli/Commands.d.ts +1 -1
  63. package/dist/cli/Commands.d.ts.map +1 -1
  64. package/dist/cli/Commands.js +5 -0
  65. package/dist/cli/Commands.js.map +1 -1
  66. package/dist/cli/ConfigCommand.d.ts.map +1 -1
  67. package/dist/cli/ConfigCommand.js +10 -0
  68. package/dist/cli/ConfigCommand.js.map +1 -1
  69. package/dist/cli/Doctor.d.ts.map +1 -1
  70. package/dist/cli/Doctor.js +67 -1
  71. package/dist/cli/Doctor.js.map +1 -1
  72. package/dist/cli/Help.d.ts.map +1 -1
  73. package/dist/cli/Help.js +18 -1
  74. package/dist/cli/Help.js.map +1 -1
  75. package/dist/cli/Host.d.ts +5 -2
  76. package/dist/cli/Host.d.ts.map +1 -1
  77. package/dist/cli/Host.js +24 -2
  78. package/dist/cli/Host.js.map +1 -1
  79. package/dist/cli/Identity.d.ts +13 -1
  80. package/dist/cli/Identity.d.ts.map +1 -1
  81. package/dist/cli/Identity.js +25 -2
  82. package/dist/cli/Identity.js.map +1 -1
  83. package/dist/cli/Profile.d.ts +24 -0
  84. package/dist/cli/Profile.d.ts.map +1 -0
  85. package/dist/cli/Profile.js +168 -0
  86. package/dist/cli/Profile.js.map +1 -0
  87. package/dist/cli/Records.d.ts +15 -0
  88. package/dist/cli/Records.d.ts.map +1 -0
  89. package/dist/cli/Records.js +205 -0
  90. package/dist/cli/Records.js.map +1 -0
  91. package/dist/cli/Status.d.ts +23 -0
  92. package/dist/cli/Status.d.ts.map +1 -1
  93. package/dist/cli/Status.js +80 -18
  94. package/dist/cli/Status.js.map +1 -1
  95. package/dist/cli/VerifyAcceptance.d.ts +38 -0
  96. package/dist/cli/VerifyAcceptance.d.ts.map +1 -0
  97. package/dist/cli/VerifyAcceptance.js +143 -0
  98. package/dist/cli/VerifyAcceptance.js.map +1 -0
  99. package/dist/config/ConfigKeys.d.ts +2 -2
  100. package/dist/config/ConfigKeys.d.ts.map +1 -1
  101. package/dist/config/ConfigKeys.js +6 -0
  102. package/dist/config/ConfigKeys.js.map +1 -1
  103. package/dist/config/ExecutorConfig.d.ts +35 -1
  104. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  105. package/dist/config/ExecutorConfig.js +53 -1
  106. package/dist/config/ExecutorConfig.js.map +1 -1
  107. package/dist/egress/ZoneHttpClient.d.ts +3 -0
  108. package/dist/egress/ZoneHttpClient.d.ts.map +1 -0
  109. package/dist/egress/ZoneHttpClient.js +72 -0
  110. package/dist/egress/ZoneHttpClient.js.map +1 -0
  111. package/dist/exposure/DecionisExposureLedger.d.ts +44 -0
  112. package/dist/exposure/DecionisExposureLedger.d.ts.map +1 -0
  113. package/dist/exposure/DecionisExposureLedger.js +175 -0
  114. package/dist/exposure/DecionisExposureLedger.js.map +1 -0
  115. package/dist/exposure/ExposureDeclaration.d.ts +68 -0
  116. package/dist/exposure/ExposureDeclaration.d.ts.map +1 -0
  117. package/dist/exposure/ExposureDeclaration.js +83 -0
  118. package/dist/exposure/ExposureDeclaration.js.map +1 -0
  119. package/dist/exposure/ExposureFacts.d.ts +61 -0
  120. package/dist/exposure/ExposureFacts.d.ts.map +1 -0
  121. package/dist/exposure/ExposureFacts.js +201 -0
  122. package/dist/exposure/ExposureFacts.js.map +1 -0
  123. package/dist/exposure/ExposureGate.d.ts +144 -0
  124. package/dist/exposure/ExposureGate.d.ts.map +1 -0
  125. package/dist/exposure/ExposureGate.js +446 -0
  126. package/dist/exposure/ExposureGate.js.map +1 -0
  127. package/dist/exposure/ExposureLedger.d.ts +93 -0
  128. package/dist/exposure/ExposureLedger.d.ts.map +1 -0
  129. package/dist/exposure/ExposureLedger.js +24 -0
  130. package/dist/exposure/ExposureLedger.js.map +1 -0
  131. package/dist/gateway/AttemptStore.d.ts +83 -0
  132. package/dist/gateway/AttemptStore.d.ts.map +1 -0
  133. package/dist/gateway/AttemptStore.js +229 -0
  134. package/dist/gateway/AttemptStore.js.map +1 -0
  135. package/dist/gateway/ForwardHandler.d.ts +50 -6
  136. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  137. package/dist/gateway/ForwardHandler.js +58 -14
  138. package/dist/gateway/ForwardHandler.js.map +1 -1
  139. package/dist/gateway/Gateway.d.ts +347 -15
  140. package/dist/gateway/Gateway.d.ts.map +1 -1
  141. package/dist/gateway/Gateway.js +1524 -63
  142. package/dist/gateway/Gateway.js.map +1 -1
  143. package/dist/gateway/GatewayConfig.d.ts +295 -0
  144. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  145. package/dist/gateway/GatewayConfig.js +485 -13
  146. package/dist/gateway/GatewayConfig.js.map +1 -1
  147. package/dist/gateway/GatewayManifest.d.ts +18 -0
  148. package/dist/gateway/GatewayManifest.d.ts.map +1 -0
  149. package/dist/gateway/GatewayManifest.js +42 -0
  150. package/dist/gateway/GatewayManifest.js.map +1 -0
  151. package/dist/gateway/GatewayMetrics.d.ts +12 -4
  152. package/dist/gateway/GatewayMetrics.d.ts.map +1 -1
  153. package/dist/gateway/GatewayMetrics.js +5 -0
  154. package/dist/gateway/GatewayMetrics.js.map +1 -1
  155. package/dist/gateway/GatewayReport.d.ts +39 -2
  156. package/dist/gateway/GatewayReport.d.ts.map +1 -1
  157. package/dist/gateway/GatewayReport.js +14 -0
  158. package/dist/gateway/GatewayReport.js.map +1 -1
  159. package/dist/gateway/HoldStore.d.ts +89 -0
  160. package/dist/gateway/HoldStore.d.ts.map +1 -0
  161. package/dist/gateway/HoldStore.js +280 -0
  162. package/dist/gateway/HoldStore.js.map +1 -0
  163. package/dist/gateway/InterceptedRequest.d.ts +55 -1
  164. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  165. package/dist/gateway/InterceptedRequest.js +63 -1
  166. package/dist/gateway/InterceptedRequest.js.map +1 -1
  167. package/dist/gateway/PolicySelector.d.ts +5 -0
  168. package/dist/gateway/PolicySelector.d.ts.map +1 -0
  169. package/dist/gateway/PolicySelector.js +9 -0
  170. package/dist/gateway/PolicySelector.js.map +1 -0
  171. package/dist/gateway/RouteTable.d.ts +72 -7
  172. package/dist/gateway/RouteTable.d.ts.map +1 -1
  173. package/dist/gateway/RouteTable.js +133 -9
  174. package/dist/gateway/RouteTable.js.map +1 -1
  175. package/dist/gateway/ShadowLedger.d.ts +11 -0
  176. package/dist/gateway/ShadowLedger.d.ts.map +1 -1
  177. package/dist/gateway/ShadowLedger.js +11 -0
  178. package/dist/gateway/ShadowLedger.js.map +1 -1
  179. package/dist/gateway/SubjectSessions.d.ts +113 -0
  180. package/dist/gateway/SubjectSessions.d.ts.map +1 -0
  181. package/dist/gateway/SubjectSessions.js +219 -0
  182. package/dist/gateway/SubjectSessions.js.map +1 -0
  183. package/dist/gateway/TargetEffect.d.ts +74 -0
  184. package/dist/gateway/TargetEffect.d.ts.map +1 -0
  185. package/dist/gateway/TargetEffect.js +95 -0
  186. package/dist/gateway/TargetEffect.js.map +1 -0
  187. package/dist/gateway/TargetReader.d.ts +70 -0
  188. package/dist/gateway/TargetReader.d.ts.map +1 -0
  189. package/dist/gateway/TargetReader.js +106 -0
  190. package/dist/gateway/TargetReader.js.map +1 -0
  191. package/dist/gateway/Upstream.d.ts +26 -0
  192. package/dist/gateway/Upstream.d.ts.map +1 -1
  193. package/dist/gateway/Upstream.js +42 -3
  194. package/dist/gateway/Upstream.js.map +1 -1
  195. package/dist/hosted/TenantHost.d.ts +26 -6
  196. package/dist/hosted/TenantHost.d.ts.map +1 -1
  197. package/dist/hosted/TenantHost.js +45 -10
  198. package/dist/hosted/TenantHost.js.map +1 -1
  199. package/dist/hosted/TenantRegistry.d.ts +28 -0
  200. package/dist/hosted/TenantRegistry.d.ts.map +1 -1
  201. package/dist/hosted/TenantRegistry.js +60 -1
  202. package/dist/hosted/TenantRegistry.js.map +1 -1
  203. package/dist/http/GatewayHttpServer.d.ts +7 -0
  204. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  205. package/dist/http/GatewayHttpServer.js +103 -3
  206. package/dist/http/GatewayHttpServer.js.map +1 -1
  207. package/dist/identity/WorkloadJwtVerifier.d.ts +13 -0
  208. package/dist/identity/WorkloadJwtVerifier.d.ts.map +1 -1
  209. package/dist/identity/WorkloadJwtVerifier.js +40 -8
  210. package/dist/identity/WorkloadJwtVerifier.js.map +1 -1
  211. package/dist/incident/HaltSwitch.d.ts +10 -2
  212. package/dist/incident/HaltSwitch.d.ts.map +1 -1
  213. package/dist/incident/HaltSwitch.js +22 -2
  214. package/dist/incident/HaltSwitch.js.map +1 -1
  215. package/dist/incident/SecurityEvents.d.ts +18 -0
  216. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  217. package/dist/incident/SecurityEvents.js +17 -0
  218. package/dist/incident/SecurityEvents.js.map +1 -1
  219. package/dist/limits/HardLimits.d.ts.map +1 -1
  220. package/dist/limits/HardLimits.js.map +1 -1
  221. package/dist/outcomes/CardOutcomeEvidence.d.ts +56 -0
  222. package/dist/outcomes/CardOutcomeEvidence.d.ts.map +1 -0
  223. package/dist/outcomes/CardOutcomeEvidence.js +211 -0
  224. package/dist/outcomes/CardOutcomeEvidence.js.map +1 -0
  225. package/dist/outcomes/CardOutcomeFact.d.ts +90 -0
  226. package/dist/outcomes/CardOutcomeFact.d.ts.map +1 -0
  227. package/dist/outcomes/CardOutcomeFact.js +76 -0
  228. package/dist/outcomes/CardOutcomeFact.js.map +1 -0
  229. package/dist/outcomes/CardOutcomeLedger.d.ts +26 -0
  230. package/dist/outcomes/CardOutcomeLedger.d.ts.map +1 -0
  231. package/dist/outcomes/CardOutcomeLedger.js +31 -0
  232. package/dist/outcomes/CardOutcomeLedger.js.map +1 -0
  233. package/dist/outcomes/CardOutcomeRecorder.d.ts +35 -0
  234. package/dist/outcomes/CardOutcomeRecorder.d.ts.map +1 -0
  235. package/dist/outcomes/CardOutcomeRecorder.js +84 -0
  236. package/dist/outcomes/CardOutcomeRecorder.js.map +1 -0
  237. package/dist/outcomes/CardOutcomes.d.ts +68 -0
  238. package/dist/outcomes/CardOutcomes.d.ts.map +1 -0
  239. package/dist/outcomes/CardOutcomes.js +191 -0
  240. package/dist/outcomes/CardOutcomes.js.map +1 -0
  241. package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts +54 -0
  242. package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts.map +1 -0
  243. package/dist/outcomes/CoreOutcomeEvidenceClient.js +116 -0
  244. package/dist/outcomes/CoreOutcomeEvidenceClient.js.map +1 -0
  245. package/dist/outcomes/FileCardOutcomeLedger.d.ts +36 -0
  246. package/dist/outcomes/FileCardOutcomeLedger.d.ts.map +1 -0
  247. package/dist/outcomes/FileCardOutcomeLedger.js +152 -0
  248. package/dist/outcomes/FileCardOutcomeLedger.js.map +1 -0
  249. package/dist/outcomes/OutcomeEvidence.d.ts +238 -0
  250. package/dist/outcomes/OutcomeEvidence.d.ts.map +1 -0
  251. package/dist/outcomes/OutcomeEvidence.js +130 -0
  252. package/dist/outcomes/OutcomeEvidence.js.map +1 -0
  253. package/dist/outcomes/OutcomeEvidencePublisher.d.ts +81 -0
  254. package/dist/outcomes/OutcomeEvidencePublisher.d.ts.map +1 -0
  255. package/dist/outcomes/OutcomeEvidencePublisher.js +189 -0
  256. package/dist/outcomes/OutcomeEvidencePublisher.js.map +1 -0
  257. package/dist/outcomes/OutcomeEvidenceStore.d.ts +57 -0
  258. package/dist/outcomes/OutcomeEvidenceStore.d.ts.map +1 -0
  259. package/dist/outcomes/OutcomeEvidenceStore.js +191 -0
  260. package/dist/outcomes/OutcomeEvidenceStore.js.map +1 -0
  261. package/dist/posture/ActionSpaceDrift.d.ts +40 -0
  262. package/dist/posture/ActionSpaceDrift.d.ts.map +1 -0
  263. package/dist/posture/ActionSpaceDrift.js +67 -0
  264. package/dist/posture/ActionSpaceDrift.js.map +1 -0
  265. package/dist/posture/DeploymentFingerprint.d.ts +88 -0
  266. package/dist/posture/DeploymentFingerprint.d.ts.map +1 -0
  267. package/dist/posture/DeploymentFingerprint.js +78 -0
  268. package/dist/posture/DeploymentFingerprint.js.map +1 -0
  269. package/dist/secrets/SecretStore.d.ts +6 -1
  270. package/dist/secrets/SecretStore.d.ts.map +1 -1
  271. package/dist/secrets/SecretStore.js.map +1 -1
  272. package/dist/service/EscalationResolver.d.ts +6 -6
  273. package/dist/service/EscalationResolver.d.ts.map +1 -1
  274. package/dist/service/EscalationResolver.js +8 -4
  275. package/dist/service/EscalationResolver.js.map +1 -1
  276. package/dist/service/Requests.d.ts +6 -0
  277. package/dist/service/Requests.d.ts.map +1 -1
  278. package/dist/service/Requests.js +9 -1
  279. package/dist/service/Requests.js.map +1 -1
  280. package/dist/service/TrustedExecutorService.d.ts +21 -1
  281. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  282. package/dist/service/TrustedExecutorService.js +54 -13
  283. package/dist/service/TrustedExecutorService.js.map +1 -1
  284. package/dist/verify/VerifyingProvider.d.ts +32 -6
  285. package/dist/verify/VerifyingProvider.d.ts.map +1 -1
  286. package/dist/verify/VerifyingProvider.js +16 -2
  287. package/dist/verify/VerifyingProvider.js.map +1 -1
  288. package/package.json +7 -6
@@ -0,0 +1,189 @@
1
+ import { OutcomeEvidenceRefusal } from "./CoreOutcomeEvidenceClient.js";
2
+ import { OUTCOME_EVIDENCE_LIMITS, OUTCOME_SUBMISSION_VERSION, OutcomeEvidenceSchema, OutcomeEvidenceSubmissionSchema, outcomeDigest, } from "./OutcomeEvidence.js";
3
+ /**
4
+ * How far back a run reads facts. A card purchase's facts all arrive within its intent's
5
+ * lifetime and the claim's lease, minutes after its decision; three days covers that with room
6
+ * for a publisher that was down, and owed evidence is kept in the store until Core takes it.
7
+ */
8
+ export const OUTCOME_LOOKBACK_DAYS = 3;
9
+ /** Batches one run may send before it leaves the rest to the next run. */
10
+ const BATCHES_PER_RUN = 10;
11
+ /** Revision conflicts one run settles before it leaves the rest to the next run. */
12
+ const CONFLICTS_PER_RUN = 20;
13
+ /** The first retry after Core could not be reached; each further one waits four times longer. */
14
+ const FIRST_RETRY_MS = 30_000;
15
+ const DAY_MS = 86_400_000;
16
+ /**
17
+ * Feeds Core's outcome meter with the card purchases' evidence, after the fact and off the
18
+ * request path: a timer this process runs, never an authorization. A run reads the recorded
19
+ * facts, states each purchase through the producer, records a subject at a new revision only
20
+ * when its evidence changed, then sends what Core has not accepted, at most a thousand subjects
21
+ * per request. Nothing unchanged is ever sent again, so a run is idempotent and a restart
22
+ * resends nothing Core already holds. Core alone classifies and calculates.
23
+ *
24
+ * Core refuses a batch whole. A revision conflict (Core holds that revision with other content)
25
+ * moves the subject to its next revision and the batch goes again; a refusal the same batch
26
+ * cannot pass (a producer Core does not allow, evidence it refuses) stops the run until the next
27
+ * interval with the evidence still owed; an outage is retried sooner, backing off. A run never
28
+ * throws, and only one runs at a time.
29
+ */
30
+ export class OutcomeEvidencePublisher {
31
+ options;
32
+ clock;
33
+ batchSize;
34
+ running = null;
35
+ timer = null;
36
+ failures = 0;
37
+ stopped = true;
38
+ constructor(options) {
39
+ this.options = options;
40
+ this.clock = options.clock ?? (() => new Date());
41
+ const batch = options.batchSize ?? OUTCOME_EVIDENCE_LIMITS.batch;
42
+ if (!Number.isInteger(batch) || batch < 1 || batch > OUTCOME_EVIDENCE_LIMITS.batch) {
43
+ throw new Error("CARD_OUTCOMES_BATCH_INVALID");
44
+ }
45
+ if (!Number.isInteger(options.intervalMs) || options.intervalMs < 1) {
46
+ throw new Error("CARD_OUTCOMES_INTERVAL_INVALID");
47
+ }
48
+ this.batchSize = batch;
49
+ }
50
+ /** Runs now, then every interval, sooner after an outage; the timer never holds the process open. */
51
+ start() {
52
+ if (!this.stopped)
53
+ return;
54
+ this.stopped = false;
55
+ this.schedule(0);
56
+ }
57
+ stop() {
58
+ this.stopped = true;
59
+ if (this.timer !== null)
60
+ clearTimeout(this.timer);
61
+ this.timer = null;
62
+ }
63
+ /** One run; a run already under way is joined rather than doubled. */
64
+ async publish() {
65
+ this.running ??= this.run().finally(() => {
66
+ this.running = null;
67
+ });
68
+ return await this.running;
69
+ }
70
+ schedule(delayMs) {
71
+ if (this.stopped)
72
+ return;
73
+ this.timer = setTimeout(() => {
74
+ this.timer = null;
75
+ void this.publish().then((summary) => {
76
+ this.failures = summary.retry ? this.failures + 1 : 0;
77
+ this.schedule(this.nextDelay());
78
+ });
79
+ }, delayMs);
80
+ this.timer.unref();
81
+ }
82
+ /** The interval, or after an outage a shorter wait that grows fourfold and never exceeds it. */
83
+ nextDelay() {
84
+ if (this.failures === 0)
85
+ return this.options.intervalMs;
86
+ const backoff = FIRST_RETRY_MS * 4 ** Math.min(this.failures - 1, 10);
87
+ return Math.min(this.options.intervalMs, backoff);
88
+ }
89
+ async run() {
90
+ const summary = {
91
+ collected: 0,
92
+ recorded: 0,
93
+ unchanged: 0,
94
+ exhausted: 0,
95
+ invalid: 0,
96
+ submitted: 0,
97
+ accepted: 0,
98
+ duplicates: 0,
99
+ conflicts: 0,
100
+ refused: null,
101
+ retry: false,
102
+ };
103
+ try {
104
+ await this.sync(summary);
105
+ await this.submit(summary);
106
+ }
107
+ catch (error) {
108
+ summary.refused = OutcomeEvidencePublisher.code(error);
109
+ summary.retry = true;
110
+ }
111
+ try {
112
+ this.options.report?.(summary);
113
+ }
114
+ catch {
115
+ // The report is for an operator; losing it never stops the meter.
116
+ }
117
+ return summary;
118
+ }
119
+ /** States every purchase in the window and records what changed. */
120
+ async sync(summary) {
121
+ const to = this.clock();
122
+ const from = new Date(to.getTime() - OUTCOME_LOOKBACK_DAYS * DAY_MS);
123
+ const facts = await this.options.ledger.since(from);
124
+ const entries = [];
125
+ for (const draft of this.options.provider.collect(facts, { from, to })) {
126
+ summary.collected += 1;
127
+ // Never record a draft the contract would refuse; the revision is the store's to assign.
128
+ if (!OutcomeEvidenceSchema.safeParse({ ...draft, revision: 1 }).success) {
129
+ summary.invalid += 1;
130
+ continue;
131
+ }
132
+ entries.push({ draft, sha256: outcomeDigest(draft) });
133
+ }
134
+ const recorded = await this.options.store.record(entries);
135
+ summary.recorded += recorded.recorded;
136
+ summary.unchanged += recorded.unchanged;
137
+ summary.exhausted += recorded.exhausted;
138
+ await this.options.store.prune(new Date(from.getTime() - DAY_MS));
139
+ }
140
+ /** Sends what Core has not accepted, a batch at a time; Core's acceptance marks each revision sent. */
141
+ async submit(summary) {
142
+ const { store, sink } = this.options;
143
+ let batches = 0;
144
+ while (batches < BATCHES_PER_RUN) {
145
+ const owed = await store.owed(this.batchSize);
146
+ if (owed.length === 0)
147
+ return;
148
+ const submission = OutcomeEvidenceSubmissionSchema.parse({
149
+ version: OUTCOME_SUBMISSION_VERSION,
150
+ producer: "agentsafe",
151
+ org_id: this.options.orgId,
152
+ evidence: owed,
153
+ });
154
+ let answer;
155
+ try {
156
+ answer = await sink.submit(submission);
157
+ }
158
+ catch (error) {
159
+ const refusal = error instanceof OutcomeEvidenceRefusal
160
+ ? error
161
+ : new OutcomeEvidenceRefusal("OUTCOME_EVIDENCE_UNAVAILABLE", false);
162
+ if (refusal.conflict !== null && summary.conflicts < CONFLICTS_PER_RUN) {
163
+ summary.conflicts += 1;
164
+ // The same evidence goes again under the next revision; a subject with none left stops the run.
165
+ if (await store.supersede(refusal.conflict))
166
+ continue;
167
+ }
168
+ summary.refused = refusal.code;
169
+ summary.retry = !refusal.permanent;
170
+ return;
171
+ }
172
+ await store.sent(owed);
173
+ batches += 1;
174
+ summary.submitted += owed.length;
175
+ summary.accepted += answer.accepted;
176
+ summary.duplicates += answer.duplicates;
177
+ if (owed.length < this.batchSize)
178
+ return;
179
+ }
180
+ }
181
+ /** A failure's own code when it carries one in the outcome vocabulary; a generic one otherwise. */
182
+ static code(error) {
183
+ const code = error?.code;
184
+ return typeof code === "string" && /^(?:CARD_OUTCOMES|OUTCOME)_[A-Z_]{1,60}$/.test(code)
185
+ ? code
186
+ : "CARD_OUTCOMES_RUN_FAILED";
187
+ }
188
+ }
189
+ //# sourceMappingURL=OutcomeEvidencePublisher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OutcomeEvidencePublisher.js","sourceRoot":"","sources":["../../src/outcomes/OutcomeEvidencePublisher.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ import { type OutcomeEvidence, type OutcomeEvidenceDraft } from "./OutcomeEvidence.js";
2
+ /** The highest revision Core accepts for one subject. */
3
+ export declare const OUTCOME_EVIDENCE_MAX_REVISION = 10000;
4
+ export declare const OUTCOME_STATE_VERSION: "agent-safe.card-outcomes-state/1";
5
+ /** A stated draft and the digest of exactly that content. */
6
+ export interface OutcomeEvidenceEntry {
7
+ readonly draft: OutcomeEvidenceDraft;
8
+ readonly sha256: string;
9
+ }
10
+ export interface OutcomeEvidenceRecordResult {
11
+ /** New subjects (revision 1) and changed ones (the next revision). */
12
+ readonly recorded: number;
13
+ /** Subjects whose evidence was already recorded as it is. */
14
+ readonly unchanged: number;
15
+ /** Changed subjects already at the highest revision: nothing more can be stated for them. */
16
+ readonly exhausted: number;
17
+ }
18
+ /** A refusal by the store: the code, never a path or a value. */
19
+ export declare class OutcomeEvidenceStoreError extends Error {
20
+ readonly code: string;
21
+ constructor(code: string);
22
+ }
23
+ /**
24
+ * What the publisher owes Core, per subject: the evidence at its current revision, the digest of
25
+ * that content, and the revision Core last accepted. A changed draft takes the next revision, an
26
+ * unchanged one is left alone, and only the revision Core accepted is ever marked sent, so the
27
+ * same evidence is never sent twice and a subject's revision rises exactly when it changes.
28
+ *
29
+ * With a file, the whole state is written to a temporary file and renamed over the old one after
30
+ * every change, so a crash leaves the previous state or the next, never half of one. A state
31
+ * file that cannot be read as one is refused rather than replaced: starting again from nothing
32
+ * would restate every subject at revision 1, which Core already holds with other content.
33
+ */
34
+ export declare class OutcomeEvidenceStore {
35
+ private readonly file;
36
+ private subjects;
37
+ /** `file` is where the state persists; null keeps it in memory, for tests. */
38
+ constructor(file?: string | null);
39
+ record(entries: readonly OutcomeEvidenceEntry[]): Promise<OutcomeEvidenceRecordResult>;
40
+ /** Evidence whose current revision Core has not accepted, oldest action first. */
41
+ owed(limit: number): Promise<OutcomeEvidence[]>;
42
+ /** Core accepted these revisions; a subject that moved on since then stays owed. */
43
+ sent(items: readonly Pick<OutcomeEvidence, "subject_digest" | "revision">[]): Promise<number>;
44
+ /**
45
+ * Core holds this subject's revision with other content: the same evidence goes again under
46
+ * the next revision. False when the subject is unknown or has no revision left.
47
+ */
48
+ supersede(subjectDigest: string): Promise<boolean>;
49
+ /**
50
+ * Forgets subjects Core holds at their current revision that occurred before `before`: nothing
51
+ * reads their facts any more, so nothing can change them. Owed subjects are kept until sent.
52
+ */
53
+ prune(before: Date): Promise<number>;
54
+ private load;
55
+ private save;
56
+ }
57
+ //# sourceMappingURL=OutcomeEvidenceStore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OutcomeEvidenceStore.d.ts","sourceRoot":"","sources":["../../src/outcomes/OutcomeEvidenceStore.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,yDAAyD;AACzD,eAAO,MAAM,6BAA6B,QAAS,CAAC;AACpD,eAAO,MAAM,qBAAqB,EAAG,kCAA2C,CAAC;AAEjF,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,iEAAiE;AACjE,qBAAa,yBAA0B,SAAQ,KAAK;aACf,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIhD;AAgBD;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAIZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHxC,OAAO,CAAC,QAAQ,CAAqC;IAErD,8EAA8E;gBAC1C,IAAI,GAAE,MAAM,GAAG,IAAW;IAEjD,MAAM,CACjB,OAAO,EAAE,SAAS,oBAAoB,EAAE,GACvC,OAAO,CAAC,2BAA2B,CAAC;IAkCvC,kFAAkF;IACrE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAa5D,oFAAoF;IACvE,IAAI,CACf,KAAK,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,gBAAgB,GAAG,UAAU,CAAC,EAAE,GACrE,OAAO,CAAC,MAAM,CAAC;IAalB;;;OAGG;IACU,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/D;;;OAGG;IACU,KAAK,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;YAcnC,IAAI;YA+BJ,IAAI;CAenB"}
@@ -0,0 +1,191 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { readFile, rename, unlink, writeFile } from "node:fs/promises";
3
+ import { z } from "zod";
4
+ import { OutcomeEvidenceSchema, } from "./OutcomeEvidence.js";
5
+ /** The highest revision Core accepts for one subject. */
6
+ export const OUTCOME_EVIDENCE_MAX_REVISION = 10_000;
7
+ export const OUTCOME_STATE_VERSION = "agent-safe.card-outcomes-state/1";
8
+ /** A refusal by the store: the code, never a path or a value. */
9
+ export class OutcomeEvidenceStoreError extends Error {
10
+ code;
11
+ constructor(code) {
12
+ super(code);
13
+ this.code = code;
14
+ this.name = "OutcomeEvidenceStoreError";
15
+ }
16
+ }
17
+ const SubjectSchema = z.strictObject({
18
+ sha256: z.string().regex(/^[a-f0-9]{64}$/),
19
+ revision: z.number().int().min(1).max(OUTCOME_EVIDENCE_MAX_REVISION),
20
+ sent: z.number().int().min(1).max(OUTCOME_EVIDENCE_MAX_REVISION).nullable(),
21
+ evidence: OutcomeEvidenceSchema,
22
+ });
23
+ const StateSchema = z.strictObject({
24
+ version: z.literal(OUTCOME_STATE_VERSION),
25
+ subjects: z.record(z.string().regex(/^[a-f0-9]{64}$/), SubjectSchema),
26
+ });
27
+ /**
28
+ * What the publisher owes Core, per subject: the evidence at its current revision, the digest of
29
+ * that content, and the revision Core last accepted. A changed draft takes the next revision, an
30
+ * unchanged one is left alone, and only the revision Core accepted is ever marked sent, so the
31
+ * same evidence is never sent twice and a subject's revision rises exactly when it changes.
32
+ *
33
+ * With a file, the whole state is written to a temporary file and renamed over the old one after
34
+ * every change, so a crash leaves the previous state or the next, never half of one. A state
35
+ * file that cannot be read as one is refused rather than replaced: starting again from nothing
36
+ * would restate every subject at revision 1, which Core already holds with other content.
37
+ */
38
+ export class OutcomeEvidenceStore {
39
+ file;
40
+ subjects = null;
41
+ /** `file` is where the state persists; null keeps it in memory, for tests. */
42
+ constructor(file = null) {
43
+ this.file = file;
44
+ }
45
+ async record(entries) {
46
+ const subjects = await this.load();
47
+ let recorded = 0;
48
+ let unchanged = 0;
49
+ let exhausted = 0;
50
+ for (const { draft, sha256 } of entries) {
51
+ const row = subjects.get(draft.subject_digest);
52
+ if (row === undefined) {
53
+ subjects.set(draft.subject_digest, {
54
+ sha256,
55
+ revision: 1,
56
+ sent: null,
57
+ evidence: { ...draft, revision: 1 },
58
+ });
59
+ recorded += 1;
60
+ }
61
+ else if (row.sha256 === sha256) {
62
+ unchanged += 1;
63
+ }
64
+ else if (row.revision >= OUTCOME_EVIDENCE_MAX_REVISION) {
65
+ exhausted += 1;
66
+ }
67
+ else {
68
+ const revision = row.revision + 1;
69
+ subjects.set(draft.subject_digest, {
70
+ sha256,
71
+ revision,
72
+ sent: row.sent,
73
+ evidence: { ...draft, revision },
74
+ });
75
+ recorded += 1;
76
+ }
77
+ }
78
+ if (recorded > 0)
79
+ await this.save();
80
+ return { recorded, unchanged, exhausted };
81
+ }
82
+ /** Evidence whose current revision Core has not accepted, oldest action first. */
83
+ async owed(limit) {
84
+ const subjects = await this.load();
85
+ return [...subjects.values()]
86
+ .filter((row) => row.sent !== row.revision)
87
+ .sort((a, b) => Date.parse(a.evidence.occurred_at) - Date.parse(b.evidence.occurred_at) ||
88
+ a.evidence.subject_digest.localeCompare(b.evidence.subject_digest))
89
+ .slice(0, limit)
90
+ .map((row) => row.evidence);
91
+ }
92
+ /** Core accepted these revisions; a subject that moved on since then stays owed. */
93
+ async sent(items) {
94
+ const subjects = await this.load();
95
+ let marked = 0;
96
+ for (const item of items) {
97
+ const row = subjects.get(item.subject_digest);
98
+ if (row === undefined || row.revision !== item.revision)
99
+ continue;
100
+ row.sent = item.revision;
101
+ marked += 1;
102
+ }
103
+ if (marked > 0)
104
+ await this.save();
105
+ return marked;
106
+ }
107
+ /**
108
+ * Core holds this subject's revision with other content: the same evidence goes again under
109
+ * the next revision. False when the subject is unknown or has no revision left.
110
+ */
111
+ async supersede(subjectDigest) {
112
+ const subjects = await this.load();
113
+ const row = subjects.get(subjectDigest);
114
+ if (row === undefined || row.revision >= OUTCOME_EVIDENCE_MAX_REVISION)
115
+ return false;
116
+ row.revision += 1;
117
+ row.evidence = { ...row.evidence, revision: row.revision };
118
+ await this.save();
119
+ return true;
120
+ }
121
+ /**
122
+ * Forgets subjects Core holds at their current revision that occurred before `before`: nothing
123
+ * reads their facts any more, so nothing can change them. Owed subjects are kept until sent.
124
+ */
125
+ async prune(before) {
126
+ const subjects = await this.load();
127
+ const floor = before.getTime();
128
+ let pruned = 0;
129
+ for (const [subject, row] of subjects) {
130
+ if (row.sent === row.revision && Date.parse(row.evidence.occurred_at) < floor) {
131
+ subjects.delete(subject);
132
+ pruned += 1;
133
+ }
134
+ }
135
+ if (pruned > 0)
136
+ await this.save();
137
+ return pruned;
138
+ }
139
+ async load() {
140
+ if (this.subjects !== null)
141
+ return this.subjects;
142
+ if (this.file === null) {
143
+ this.subjects = new Map();
144
+ return this.subjects;
145
+ }
146
+ let text;
147
+ try {
148
+ text = await readFile(this.file, "utf8");
149
+ }
150
+ catch (error) {
151
+ if (error.code !== "ENOENT") {
152
+ throw new OutcomeEvidenceStoreError("CARD_OUTCOMES_STATE_UNREADABLE");
153
+ }
154
+ text = null;
155
+ }
156
+ if (text === null) {
157
+ this.subjects = new Map();
158
+ return this.subjects;
159
+ }
160
+ let value;
161
+ try {
162
+ value = JSON.parse(text);
163
+ }
164
+ catch {
165
+ throw new OutcomeEvidenceStoreError("CARD_OUTCOMES_STATE_UNREADABLE");
166
+ }
167
+ const parsed = StateSchema.safeParse(value);
168
+ if (!parsed.success)
169
+ throw new OutcomeEvidenceStoreError("CARD_OUTCOMES_STATE_UNREADABLE");
170
+ this.subjects = new Map(Object.entries(parsed.data.subjects));
171
+ return this.subjects;
172
+ }
173
+ async save() {
174
+ if (this.file === null || this.subjects === null)
175
+ return;
176
+ const state = {
177
+ version: OUTCOME_STATE_VERSION,
178
+ subjects: Object.fromEntries(this.subjects),
179
+ };
180
+ const temporary = `${this.file}.${randomBytes(6).toString("hex")}.tmp`;
181
+ try {
182
+ await writeFile(temporary, `${JSON.stringify(state)}\n`, { mode: 0o600, flag: "wx" });
183
+ await rename(temporary, this.file);
184
+ }
185
+ catch {
186
+ await unlink(temporary).catch(() => undefined);
187
+ throw new OutcomeEvidenceStoreError("CARD_OUTCOMES_STATE_UNWRITABLE");
188
+ }
189
+ }
190
+ }
191
+ //# sourceMappingURL=OutcomeEvidenceStore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"OutcomeEvidenceStore.js","sourceRoot":"","sources":["../../src/outcomes/OutcomeEvidenceStore.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import type { DecisionAuthority, DecisionGate } from "@decionis/agent-safe-pipeline";
2
+ /**
3
+ * `UNCHECKED` until a decision names the action space its release was
4
+ * checked against; then `MATCH` or `DRIFT` as the last one that named one.
5
+ */
6
+ export type ActionSpaceState = "UNCHECKED" | "MATCH" | "DRIFT";
7
+ export interface ActionSpaceStatus {
8
+ /** The digest of the action space this gateway loaded; null when no manifest describes it. */
9
+ readonly loaded: string | null;
10
+ /** The digest the last decision that named one gave for the release that decided. */
11
+ readonly release: string | null;
12
+ readonly state: ActionSpaceState;
13
+ /** The releases' digests recorded as drift, oldest first. */
14
+ readonly drifted: readonly string[];
15
+ }
16
+ /** How many drifting releases are remembered; past it the oldest is forgotten, and recorded again if it returns. */
17
+ export declare const MAX_REMEMBERED_RELEASES = 64;
18
+ /**
19
+ * Compares the action space this gateway loaded with the one each deciding
20
+ * release was checked against, as the authority names it on the decision
21
+ * (`actionManifestDigest`). A release that differs is a release whose coverage
22
+ * gate never saw some action this gateway can propose, or saw one it cannot:
23
+ * recorded once per release, through `onDrift`, and shown. It is a report and
24
+ * nothing more: no decision is changed, delayed or refused for it, and a
25
+ * failure to record it never reaches the decision.
26
+ */
27
+ export declare class ActionSpaceDrift {
28
+ private readonly loaded;
29
+ private readonly onDrift;
30
+ private release;
31
+ private readonly recorded;
32
+ constructor(loaded: string | null, onDrift: (release: string, decision: DecisionGate) => void);
33
+ get state(): ActionSpaceState;
34
+ status(): ActionSpaceStatus;
35
+ /** One decision: nothing when it names no release's action space. */
36
+ observe(decision: DecisionGate): void;
37
+ /** The authority, with each decision it returns observed before anyone uses it. */
38
+ observing(authority: DecisionAuthority): DecisionAuthority;
39
+ }
40
+ //# sourceMappingURL=ActionSpaceDrift.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ActionSpaceDrift.d.ts","sourceRoot":"","sources":["../../src/posture/ActionSpaceDrift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EAGjB,YAAY,EACb,MAAM,+BAA+B,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,oHAAoH;AACpH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAG3B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI;IAG7E,IAAW,KAAK,IAAI,gBAAgB,CAGnC;IAEM,MAAM,IAAI,iBAAiB;IASlC,qEAAqE;IAC9D,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAgB5C,mFAAmF;IAC5E,SAAS,CAAC,SAAS,EAAE,iBAAiB,GAAG,iBAAiB;CAgBlE"}
@@ -0,0 +1,67 @@
1
+ /** How many drifting releases are remembered; past it the oldest is forgotten, and recorded again if it returns. */
2
+ export const MAX_REMEMBERED_RELEASES = 64;
3
+ /**
4
+ * Compares the action space this gateway loaded with the one each deciding
5
+ * release was checked against, as the authority names it on the decision
6
+ * (`actionManifestDigest`). A release that differs is a release whose coverage
7
+ * gate never saw some action this gateway can propose, or saw one it cannot:
8
+ * recorded once per release, through `onDrift`, and shown. It is a report and
9
+ * nothing more: no decision is changed, delayed or refused for it, and a
10
+ * failure to record it never reaches the decision.
11
+ */
12
+ export class ActionSpaceDrift {
13
+ loaded;
14
+ onDrift;
15
+ release = null;
16
+ recorded = new Set();
17
+ constructor(loaded, onDrift) {
18
+ this.loaded = loaded;
19
+ this.onDrift = onDrift;
20
+ }
21
+ get state() {
22
+ if (this.release === null)
23
+ return "UNCHECKED";
24
+ return this.release === this.loaded ? "MATCH" : "DRIFT";
25
+ }
26
+ status() {
27
+ return {
28
+ loaded: this.loaded,
29
+ release: this.release,
30
+ state: this.state,
31
+ drifted: [...this.recorded],
32
+ };
33
+ }
34
+ /** One decision: nothing when it names no release's action space. */
35
+ observe(decision) {
36
+ const release = decision.actionManifestDigest;
37
+ if (release === undefined || release === null)
38
+ return;
39
+ this.release = release;
40
+ if (release === this.loaded || this.recorded.has(release))
41
+ return;
42
+ if (this.recorded.size === MAX_REMEMBERED_RELEASES) {
43
+ this.recorded.delete(this.recorded.values().next().value);
44
+ }
45
+ this.recorded.add(release);
46
+ try {
47
+ this.onDrift(release, decision);
48
+ }
49
+ catch {
50
+ // Report-only: a record that cannot be written leaves the decision as it was.
51
+ }
52
+ }
53
+ /** The authority, with each decision it returns observed before anyone uses it. */
54
+ observing(authority) {
55
+ return {
56
+ ...(authority.evaluationMode === undefined
57
+ ? {}
58
+ : { evaluationMode: authority.evaluationMode }),
59
+ evaluate: async (captured, evidence, options) => {
60
+ const decision = await authority.evaluate(captured, evidence, options);
61
+ this.observe(decision);
62
+ return decision;
63
+ },
64
+ };
65
+ }
66
+ }
67
+ //# sourceMappingURL=ActionSpaceDrift.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ActionSpaceDrift.js","sourceRoot":"","sources":["../../src/posture/ActionSpaceDrift.ts"],"names":[],"mappings":"AAwBA,oHAAoH;AACpH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAKR;IACA;IALX,OAAO,GAAkB,IAAI,CAAC;IACrB,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9C,YACmB,MAAqB,EACrB,OAA0D;QAD1D,WAAM,GAAN,MAAM,CAAe;QACrB,YAAO,GAAP,OAAO,CAAmD;IAC1E,CAAC;IAEJ,IAAW,KAAK;QACd,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO,WAAW,CAAC;QAC9C,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1D,CAAC;IAEM,MAAM;QACX,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,qEAAqE;IAC9D,OAAO,CAAC,QAAsB;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,oBAAoB,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO;QAClE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;QAChF,CAAC;IACH,CAAC;IAED,mFAAmF;IAC5E,SAAS,CAAC,SAA4B;QAC3C,OAAO;YACL,GAAG,CAAC,SAAS,CAAC,cAAc,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC;YACjD,QAAQ,EAAE,KAAK,EACb,QAAwB,EACxB,QAA2B,EAC3B,OAAmC,EACZ,EAAE;gBACzB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACvE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACvB,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}