@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.
- package/README.md +68 -20
- package/dist/Cli.js +30 -3
- package/dist/Cli.js.map +1 -1
- package/dist/Index.d.ts +5 -3
- package/dist/Index.d.ts.map +1 -1
- package/dist/Index.js +3 -1
- package/dist/Index.js.map +1 -1
- package/dist/TrustedExecutor.d.ts.map +1 -1
- package/dist/TrustedExecutor.js +2 -0
- package/dist/TrustedExecutor.js.map +1 -1
- package/dist/acceptance/AcceptancePlan.d.ts +109 -0
- package/dist/acceptance/AcceptancePlan.d.ts.map +1 -0
- package/dist/acceptance/AcceptancePlan.js +128 -0
- package/dist/acceptance/AcceptancePlan.js.map +1 -0
- package/dist/acceptance/AcceptanceReport.d.ts +596 -0
- package/dist/acceptance/AcceptanceReport.d.ts.map +1 -0
- package/dist/acceptance/AcceptanceReport.js +361 -0
- package/dist/acceptance/AcceptanceReport.js.map +1 -0
- package/dist/acceptance/AcceptanceRun.d.ts +118 -0
- package/dist/acceptance/AcceptanceRun.d.ts.map +1 -0
- package/dist/acceptance/AcceptanceRun.js +419 -0
- package/dist/acceptance/AcceptanceRun.js.map +1 -0
- package/dist/acceptance/Coverage.d.ts +12 -0
- package/dist/acceptance/Coverage.d.ts.map +1 -0
- package/dist/acceptance/Coverage.js +48 -0
- package/dist/acceptance/Coverage.js.map +1 -0
- package/dist/acceptance/OutageDoubles.d.ts +34 -0
- package/dist/acceptance/OutageDoubles.d.ts.map +1 -0
- package/dist/acceptance/OutageDoubles.js +67 -0
- package/dist/acceptance/OutageDoubles.js.map +1 -0
- package/dist/acceptance/ZoneProbes.d.ts +368 -0
- package/dist/acceptance/ZoneProbes.d.ts.map +1 -0
- package/dist/acceptance/ZoneProbes.js +488 -0
- package/dist/acceptance/ZoneProbes.js.map +1 -0
- package/dist/adapters/JcsDigest.d.ts +6 -5
- package/dist/adapters/JcsDigest.d.ts.map +1 -1
- package/dist/adapters/JcsDigest.js +9 -8
- package/dist/adapters/JcsDigest.js.map +1 -1
- package/dist/adapters/mcp/McpGuard.d.ts +32 -3
- package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
- package/dist/adapters/mcp/McpGuard.js +29 -5
- package/dist/adapters/mcp/McpGuard.js.map +1 -1
- package/dist/adapters/mcp/McpIntentBinder.d.ts +18 -3
- package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -1
- package/dist/adapters/mcp/McpIntentBinder.js +48 -1
- package/dist/adapters/mcp/McpIntentBinder.js.map +1 -1
- package/dist/adapters/mcp/McpInvocation.d.ts +9 -2
- package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -1
- package/dist/adapters/mcp/McpInvocation.js.map +1 -1
- package/dist/cli/Accept.d.ts +9 -0
- package/dist/cli/Accept.d.ts.map +1 -0
- package/dist/cli/Accept.js +209 -0
- package/dist/cli/Accept.js.map +1 -0
- package/dist/cli/Actions.d.ts +16 -0
- package/dist/cli/Actions.d.ts.map +1 -0
- package/dist/cli/Actions.js +194 -0
- package/dist/cli/Actions.js.map +1 -0
- package/dist/cli/Arguments.d.ts +4 -0
- package/dist/cli/Arguments.d.ts.map +1 -1
- package/dist/cli/Arguments.js +12 -3
- package/dist/cli/Arguments.js.map +1 -1
- package/dist/cli/Commands.d.ts +1 -1
- package/dist/cli/Commands.d.ts.map +1 -1
- package/dist/cli/Commands.js +5 -0
- package/dist/cli/Commands.js.map +1 -1
- package/dist/cli/ConfigCommand.d.ts.map +1 -1
- package/dist/cli/ConfigCommand.js +10 -0
- package/dist/cli/ConfigCommand.js.map +1 -1
- package/dist/cli/Doctor.d.ts.map +1 -1
- package/dist/cli/Doctor.js +67 -1
- package/dist/cli/Doctor.js.map +1 -1
- package/dist/cli/Help.d.ts.map +1 -1
- package/dist/cli/Help.js +18 -1
- package/dist/cli/Help.js.map +1 -1
- package/dist/cli/Host.d.ts +5 -2
- package/dist/cli/Host.d.ts.map +1 -1
- package/dist/cli/Host.js +24 -2
- package/dist/cli/Host.js.map +1 -1
- package/dist/cli/Identity.d.ts +13 -1
- package/dist/cli/Identity.d.ts.map +1 -1
- package/dist/cli/Identity.js +25 -2
- package/dist/cli/Identity.js.map +1 -1
- package/dist/cli/Profile.d.ts +24 -0
- package/dist/cli/Profile.d.ts.map +1 -0
- package/dist/cli/Profile.js +168 -0
- package/dist/cli/Profile.js.map +1 -0
- package/dist/cli/Records.d.ts +15 -0
- package/dist/cli/Records.d.ts.map +1 -0
- package/dist/cli/Records.js +205 -0
- package/dist/cli/Records.js.map +1 -0
- package/dist/cli/Status.d.ts +23 -0
- package/dist/cli/Status.d.ts.map +1 -1
- package/dist/cli/Status.js +80 -18
- package/dist/cli/Status.js.map +1 -1
- package/dist/cli/VerifyAcceptance.d.ts +38 -0
- package/dist/cli/VerifyAcceptance.d.ts.map +1 -0
- package/dist/cli/VerifyAcceptance.js +143 -0
- package/dist/cli/VerifyAcceptance.js.map +1 -0
- package/dist/config/ConfigKeys.d.ts +2 -2
- package/dist/config/ConfigKeys.d.ts.map +1 -1
- package/dist/config/ConfigKeys.js +6 -0
- package/dist/config/ConfigKeys.js.map +1 -1
- package/dist/config/ExecutorConfig.d.ts +35 -1
- package/dist/config/ExecutorConfig.d.ts.map +1 -1
- package/dist/config/ExecutorConfig.js +53 -1
- package/dist/config/ExecutorConfig.js.map +1 -1
- package/dist/egress/ZoneHttpClient.d.ts +3 -0
- package/dist/egress/ZoneHttpClient.d.ts.map +1 -0
- package/dist/egress/ZoneHttpClient.js +72 -0
- package/dist/egress/ZoneHttpClient.js.map +1 -0
- package/dist/exposure/DecionisExposureLedger.d.ts +44 -0
- package/dist/exposure/DecionisExposureLedger.d.ts.map +1 -0
- package/dist/exposure/DecionisExposureLedger.js +175 -0
- package/dist/exposure/DecionisExposureLedger.js.map +1 -0
- package/dist/exposure/ExposureDeclaration.d.ts +68 -0
- package/dist/exposure/ExposureDeclaration.d.ts.map +1 -0
- package/dist/exposure/ExposureDeclaration.js +83 -0
- package/dist/exposure/ExposureDeclaration.js.map +1 -0
- package/dist/exposure/ExposureFacts.d.ts +61 -0
- package/dist/exposure/ExposureFacts.d.ts.map +1 -0
- package/dist/exposure/ExposureFacts.js +201 -0
- package/dist/exposure/ExposureFacts.js.map +1 -0
- package/dist/exposure/ExposureGate.d.ts +144 -0
- package/dist/exposure/ExposureGate.d.ts.map +1 -0
- package/dist/exposure/ExposureGate.js +446 -0
- package/dist/exposure/ExposureGate.js.map +1 -0
- package/dist/exposure/ExposureLedger.d.ts +93 -0
- package/dist/exposure/ExposureLedger.d.ts.map +1 -0
- package/dist/exposure/ExposureLedger.js +24 -0
- package/dist/exposure/ExposureLedger.js.map +1 -0
- package/dist/gateway/AttemptStore.d.ts +83 -0
- package/dist/gateway/AttemptStore.d.ts.map +1 -0
- package/dist/gateway/AttemptStore.js +229 -0
- package/dist/gateway/AttemptStore.js.map +1 -0
- package/dist/gateway/ForwardHandler.d.ts +50 -6
- package/dist/gateway/ForwardHandler.d.ts.map +1 -1
- package/dist/gateway/ForwardHandler.js +58 -14
- package/dist/gateway/ForwardHandler.js.map +1 -1
- package/dist/gateway/Gateway.d.ts +347 -15
- package/dist/gateway/Gateway.d.ts.map +1 -1
- package/dist/gateway/Gateway.js +1524 -63
- package/dist/gateway/Gateway.js.map +1 -1
- package/dist/gateway/GatewayConfig.d.ts +295 -0
- package/dist/gateway/GatewayConfig.d.ts.map +1 -1
- package/dist/gateway/GatewayConfig.js +485 -13
- package/dist/gateway/GatewayConfig.js.map +1 -1
- package/dist/gateway/GatewayManifest.d.ts +18 -0
- package/dist/gateway/GatewayManifest.d.ts.map +1 -0
- package/dist/gateway/GatewayManifest.js +42 -0
- package/dist/gateway/GatewayManifest.js.map +1 -0
- package/dist/gateway/GatewayMetrics.d.ts +12 -4
- package/dist/gateway/GatewayMetrics.d.ts.map +1 -1
- package/dist/gateway/GatewayMetrics.js +5 -0
- package/dist/gateway/GatewayMetrics.js.map +1 -1
- package/dist/gateway/GatewayReport.d.ts +39 -2
- package/dist/gateway/GatewayReport.d.ts.map +1 -1
- package/dist/gateway/GatewayReport.js +14 -0
- package/dist/gateway/GatewayReport.js.map +1 -1
- package/dist/gateway/HoldStore.d.ts +89 -0
- package/dist/gateway/HoldStore.d.ts.map +1 -0
- package/dist/gateway/HoldStore.js +280 -0
- package/dist/gateway/HoldStore.js.map +1 -0
- package/dist/gateway/InterceptedRequest.d.ts +55 -1
- package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
- package/dist/gateway/InterceptedRequest.js +63 -1
- package/dist/gateway/InterceptedRequest.js.map +1 -1
- package/dist/gateway/PolicySelector.d.ts +5 -0
- package/dist/gateway/PolicySelector.d.ts.map +1 -0
- package/dist/gateway/PolicySelector.js +9 -0
- package/dist/gateway/PolicySelector.js.map +1 -0
- package/dist/gateway/RouteTable.d.ts +72 -7
- package/dist/gateway/RouteTable.d.ts.map +1 -1
- package/dist/gateway/RouteTable.js +133 -9
- package/dist/gateway/RouteTable.js.map +1 -1
- package/dist/gateway/ShadowLedger.d.ts +11 -0
- package/dist/gateway/ShadowLedger.d.ts.map +1 -1
- package/dist/gateway/ShadowLedger.js +11 -0
- package/dist/gateway/ShadowLedger.js.map +1 -1
- package/dist/gateway/SubjectSessions.d.ts +113 -0
- package/dist/gateway/SubjectSessions.d.ts.map +1 -0
- package/dist/gateway/SubjectSessions.js +219 -0
- package/dist/gateway/SubjectSessions.js.map +1 -0
- package/dist/gateway/TargetEffect.d.ts +74 -0
- package/dist/gateway/TargetEffect.d.ts.map +1 -0
- package/dist/gateway/TargetEffect.js +95 -0
- package/dist/gateway/TargetEffect.js.map +1 -0
- package/dist/gateway/TargetReader.d.ts +70 -0
- package/dist/gateway/TargetReader.d.ts.map +1 -0
- package/dist/gateway/TargetReader.js +106 -0
- package/dist/gateway/TargetReader.js.map +1 -0
- package/dist/gateway/Upstream.d.ts +26 -0
- package/dist/gateway/Upstream.d.ts.map +1 -1
- package/dist/gateway/Upstream.js +42 -3
- package/dist/gateway/Upstream.js.map +1 -1
- package/dist/hosted/TenantHost.d.ts +26 -6
- package/dist/hosted/TenantHost.d.ts.map +1 -1
- package/dist/hosted/TenantHost.js +45 -10
- package/dist/hosted/TenantHost.js.map +1 -1
- package/dist/hosted/TenantRegistry.d.ts +28 -0
- package/dist/hosted/TenantRegistry.d.ts.map +1 -1
- package/dist/hosted/TenantRegistry.js +60 -1
- package/dist/hosted/TenantRegistry.js.map +1 -1
- package/dist/http/GatewayHttpServer.d.ts +7 -0
- package/dist/http/GatewayHttpServer.d.ts.map +1 -1
- package/dist/http/GatewayHttpServer.js +103 -3
- package/dist/http/GatewayHttpServer.js.map +1 -1
- package/dist/identity/WorkloadJwtVerifier.d.ts +13 -0
- package/dist/identity/WorkloadJwtVerifier.d.ts.map +1 -1
- package/dist/identity/WorkloadJwtVerifier.js +40 -8
- package/dist/identity/WorkloadJwtVerifier.js.map +1 -1
- package/dist/incident/HaltSwitch.d.ts +10 -2
- package/dist/incident/HaltSwitch.d.ts.map +1 -1
- package/dist/incident/HaltSwitch.js +22 -2
- package/dist/incident/HaltSwitch.js.map +1 -1
- package/dist/incident/SecurityEvents.d.ts +18 -0
- package/dist/incident/SecurityEvents.d.ts.map +1 -1
- package/dist/incident/SecurityEvents.js +17 -0
- package/dist/incident/SecurityEvents.js.map +1 -1
- package/dist/limits/HardLimits.d.ts.map +1 -1
- package/dist/limits/HardLimits.js.map +1 -1
- package/dist/outcomes/CardOutcomeEvidence.d.ts +56 -0
- package/dist/outcomes/CardOutcomeEvidence.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeEvidence.js +211 -0
- package/dist/outcomes/CardOutcomeEvidence.js.map +1 -0
- package/dist/outcomes/CardOutcomeFact.d.ts +90 -0
- package/dist/outcomes/CardOutcomeFact.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeFact.js +76 -0
- package/dist/outcomes/CardOutcomeFact.js.map +1 -0
- package/dist/outcomes/CardOutcomeLedger.d.ts +26 -0
- package/dist/outcomes/CardOutcomeLedger.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeLedger.js +31 -0
- package/dist/outcomes/CardOutcomeLedger.js.map +1 -0
- package/dist/outcomes/CardOutcomeRecorder.d.ts +35 -0
- package/dist/outcomes/CardOutcomeRecorder.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeRecorder.js +84 -0
- package/dist/outcomes/CardOutcomeRecorder.js.map +1 -0
- package/dist/outcomes/CardOutcomes.d.ts +68 -0
- package/dist/outcomes/CardOutcomes.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomes.js +191 -0
- package/dist/outcomes/CardOutcomes.js.map +1 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts +54 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts.map +1 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.js +116 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.js.map +1 -0
- package/dist/outcomes/FileCardOutcomeLedger.d.ts +36 -0
- package/dist/outcomes/FileCardOutcomeLedger.d.ts.map +1 -0
- package/dist/outcomes/FileCardOutcomeLedger.js +152 -0
- package/dist/outcomes/FileCardOutcomeLedger.js.map +1 -0
- package/dist/outcomes/OutcomeEvidence.d.ts +238 -0
- package/dist/outcomes/OutcomeEvidence.d.ts.map +1 -0
- package/dist/outcomes/OutcomeEvidence.js +130 -0
- package/dist/outcomes/OutcomeEvidence.js.map +1 -0
- package/dist/outcomes/OutcomeEvidencePublisher.d.ts +81 -0
- package/dist/outcomes/OutcomeEvidencePublisher.d.ts.map +1 -0
- package/dist/outcomes/OutcomeEvidencePublisher.js +189 -0
- package/dist/outcomes/OutcomeEvidencePublisher.js.map +1 -0
- package/dist/outcomes/OutcomeEvidenceStore.d.ts +57 -0
- package/dist/outcomes/OutcomeEvidenceStore.d.ts.map +1 -0
- package/dist/outcomes/OutcomeEvidenceStore.js +191 -0
- package/dist/outcomes/OutcomeEvidenceStore.js.map +1 -0
- package/dist/posture/ActionSpaceDrift.d.ts +40 -0
- package/dist/posture/ActionSpaceDrift.d.ts.map +1 -0
- package/dist/posture/ActionSpaceDrift.js +67 -0
- package/dist/posture/ActionSpaceDrift.js.map +1 -0
- package/dist/posture/DeploymentFingerprint.d.ts +88 -0
- package/dist/posture/DeploymentFingerprint.d.ts.map +1 -0
- package/dist/posture/DeploymentFingerprint.js +78 -0
- package/dist/posture/DeploymentFingerprint.js.map +1 -0
- package/dist/secrets/SecretStore.d.ts +6 -1
- package/dist/secrets/SecretStore.d.ts.map +1 -1
- package/dist/secrets/SecretStore.js.map +1 -1
- package/dist/service/EscalationResolver.d.ts +6 -6
- package/dist/service/EscalationResolver.d.ts.map +1 -1
- package/dist/service/EscalationResolver.js +8 -4
- package/dist/service/EscalationResolver.js.map +1 -1
- package/dist/service/Requests.d.ts +6 -0
- package/dist/service/Requests.d.ts.map +1 -1
- package/dist/service/Requests.js +9 -1
- package/dist/service/Requests.js.map +1 -1
- package/dist/service/TrustedExecutorService.d.ts +21 -1
- package/dist/service/TrustedExecutorService.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.js +54 -13
- package/dist/service/TrustedExecutorService.js.map +1 -1
- package/dist/verify/VerifyingProvider.d.ts +32 -6
- package/dist/verify/VerifyingProvider.d.ts.map +1 -1
- package/dist/verify/VerifyingProvider.js +16 -2
- package/dist/verify/VerifyingProvider.js.map +1 -1
- package/package.json +7 -6
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
import { constants, mkdirSync, statSync } from "node:fs";
|
|
2
|
+
import { open, readFile, readdir } from "node:fs/promises";
|
|
3
|
+
import { hostname } from "node:os";
|
|
4
|
+
import { join } from "node:path";
|
|
5
|
+
import { CardOutcomeFactSchema } from "./CardOutcomeFact.js";
|
|
6
|
+
import { CardOutcomeLedgerError, oldestFirst, } from "./CardOutcomeLedger.js";
|
|
7
|
+
/** The longest line a read takes for a fact; a longer one is skipped, never parsed. */
|
|
8
|
+
export const MAX_FACT_BYTES = 16 * 1024;
|
|
9
|
+
const FILE_PATTERN = /^card-outcomes-(\d{4}-\d{2}-\d{2})\.([a-z0-9-]{1,63})\.jsonl$/;
|
|
10
|
+
/**
|
|
11
|
+
* Append, create, write only; never through a symbolic link planted where the file should be,
|
|
12
|
+
* and never waiting on a pipe planted there either.
|
|
13
|
+
*/
|
|
14
|
+
const APPEND_FLAGS = constants.O_WRONLY |
|
|
15
|
+
constants.O_APPEND |
|
|
16
|
+
constants.O_CREAT |
|
|
17
|
+
(constants.O_NOFOLLOW ?? 0) |
|
|
18
|
+
(constants.O_NONBLOCK ?? 0);
|
|
19
|
+
/**
|
|
20
|
+
* The outcome facts as append-only JSONL, one file per UTC day and per replica:
|
|
21
|
+
* `card-outcomes-<day>.<replica>.jsonl`. Replicas that share the directory (a volume every
|
|
22
|
+
* replica mounts) each write their own file, so no two processes append to one; the producer
|
|
23
|
+
* reads every replica's files and orders the facts by time, so a purchase held on one replica
|
|
24
|
+
* and claimed on another reads as one purchase.
|
|
25
|
+
*
|
|
26
|
+
* The directory is created private to this process, a path that is not a regular file is
|
|
27
|
+
* refused, and a line that is not a fact, or is longer than the bound, is skipped when read
|
|
28
|
+
* rather than trusted. Nothing here is deleted: older days are left for the operator's
|
|
29
|
+
* retention, and only the days a read asks for are opened.
|
|
30
|
+
*/
|
|
31
|
+
export class FileCardOutcomeLedger {
|
|
32
|
+
directory;
|
|
33
|
+
replica;
|
|
34
|
+
constructor(directory, options = {}) {
|
|
35
|
+
this.directory = directory;
|
|
36
|
+
try {
|
|
37
|
+
mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
38
|
+
if (!statSync(directory).isDirectory())
|
|
39
|
+
throw new Error("not a directory");
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
throw new CardOutcomeLedgerError("CARD_OUTCOMES_DIRECTORY_UNUSABLE");
|
|
43
|
+
}
|
|
44
|
+
this.replica = FileCardOutcomeLedger.replicaName(options.replica ?? hostname());
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* A replica's name as a file may carry it: lowercase letters, digits and dashes, at most 63,
|
|
48
|
+
* so a pod name is kept as it reads and anything else becomes a dash. Linear, with no pattern
|
|
49
|
+
* a hostile name could make backtrack.
|
|
50
|
+
*/
|
|
51
|
+
static replicaName(value) {
|
|
52
|
+
let name = "";
|
|
53
|
+
for (const character of value.toLowerCase()) {
|
|
54
|
+
const unit = character.charCodeAt(0);
|
|
55
|
+
const kept = character.length === 1 &&
|
|
56
|
+
((unit >= 0x61 && unit <= 0x7a) || (unit >= 0x30 && unit <= 0x39));
|
|
57
|
+
name += kept ? character : "-";
|
|
58
|
+
if (name.length >= 63)
|
|
59
|
+
break;
|
|
60
|
+
}
|
|
61
|
+
let start = 0;
|
|
62
|
+
let end = name.length;
|
|
63
|
+
while (start < end && name[start] === "-")
|
|
64
|
+
start += 1;
|
|
65
|
+
while (end > start && name[end - 1] === "-")
|
|
66
|
+
end -= 1;
|
|
67
|
+
return start === end ? "local" : name.slice(start, end);
|
|
68
|
+
}
|
|
69
|
+
async append(facts) {
|
|
70
|
+
const days = new Map();
|
|
71
|
+
for (const fact of facts) {
|
|
72
|
+
const parsed = CardOutcomeFactSchema.safeParse(fact);
|
|
73
|
+
if (!parsed.success)
|
|
74
|
+
throw new CardOutcomeLedgerError("CARD_OUTCOMES_FACT_INVALID");
|
|
75
|
+
// The schema bounds every field, so a fact's line is always well inside the read bound.
|
|
76
|
+
const line = `${JSON.stringify(parsed.data)}\n`;
|
|
77
|
+
const day = new Date(parsed.data.at).toISOString().slice(0, 10);
|
|
78
|
+
const lines = days.get(day) ?? [];
|
|
79
|
+
lines.push(line);
|
|
80
|
+
days.set(day, lines);
|
|
81
|
+
}
|
|
82
|
+
for (const [day, lines] of days) {
|
|
83
|
+
await this.write(join(this.directory, `card-outcomes-${day}.${this.replica}.jsonl`), lines);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
async since(from) {
|
|
87
|
+
const earliest = from.toISOString().slice(0, 10);
|
|
88
|
+
let entries;
|
|
89
|
+
try {
|
|
90
|
+
entries = await readdir(this.directory);
|
|
91
|
+
}
|
|
92
|
+
catch {
|
|
93
|
+
throw new CardOutcomeLedgerError("CARD_OUTCOMES_UNREADABLE");
|
|
94
|
+
}
|
|
95
|
+
const files = entries
|
|
96
|
+
.map((entry) => ({ entry, match: FILE_PATTERN.exec(entry) }))
|
|
97
|
+
.filter(({ match }) => match !== null && (match[1] ?? "") >= earliest)
|
|
98
|
+
.map(({ entry }) => entry)
|
|
99
|
+
.sort();
|
|
100
|
+
const facts = [];
|
|
101
|
+
for (const entry of files) {
|
|
102
|
+
let text;
|
|
103
|
+
try {
|
|
104
|
+
text = await readFile(join(this.directory, entry), "utf8");
|
|
105
|
+
}
|
|
106
|
+
catch {
|
|
107
|
+
// A file another replica is rotating, or one removed by retention: nothing to read.
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
for (const line of text.split("\n")) {
|
|
111
|
+
if (line.trim() === "" || line.length > MAX_FACT_BYTES)
|
|
112
|
+
continue;
|
|
113
|
+
let value;
|
|
114
|
+
try {
|
|
115
|
+
value = JSON.parse(line);
|
|
116
|
+
}
|
|
117
|
+
catch {
|
|
118
|
+
continue;
|
|
119
|
+
}
|
|
120
|
+
const fact = CardOutcomeFactSchema.safeParse(value);
|
|
121
|
+
if (fact.success)
|
|
122
|
+
facts.push(fact.data);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
return oldestFirst(facts, from);
|
|
126
|
+
}
|
|
127
|
+
/** One day's lines, appended in one write to a file that is a regular file and nothing else. */
|
|
128
|
+
async write(path, lines) {
|
|
129
|
+
let handle;
|
|
130
|
+
try {
|
|
131
|
+
handle = await open(path, APPEND_FLAGS, 0o600);
|
|
132
|
+
}
|
|
133
|
+
catch {
|
|
134
|
+
throw new CardOutcomeLedgerError("CARD_OUTCOMES_UNWRITABLE");
|
|
135
|
+
}
|
|
136
|
+
try {
|
|
137
|
+
if (!(await handle.stat()).isFile()) {
|
|
138
|
+
throw new CardOutcomeLedgerError("CARD_OUTCOMES_NOT_A_FILE");
|
|
139
|
+
}
|
|
140
|
+
await handle.write(lines.join(""));
|
|
141
|
+
}
|
|
142
|
+
catch (error) {
|
|
143
|
+
throw error instanceof CardOutcomeLedgerError
|
|
144
|
+
? error
|
|
145
|
+
: new CardOutcomeLedgerError("CARD_OUTCOMES_WRITE_FAILED");
|
|
146
|
+
}
|
|
147
|
+
finally {
|
|
148
|
+
await handle.close().catch(() => undefined);
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
//# sourceMappingURL=FileCardOutcomeLedger.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FileCardOutcomeLedger.js","sourceRoot":"","sources":["../../src/outcomes/FileCardOutcomeLedger.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { JsonValue } from "@decionis/agent-safe-pipeline";
|
|
3
|
+
/**
|
|
4
|
+
* Core's outcome evidence wire contract (`decionis.outcomes.evidence/1`, inside
|
|
5
|
+
* `decionis.outcomes.submission/1`), mirrored here. Core owns the meter: the signed agreement,
|
|
6
|
+
* the one `OutcomeCalculator` that classifies, the append-only ledger and the signed monthly
|
|
7
|
+
* statement. AgentSafe only states what it recorded about its card purchases and submits it with
|
|
8
|
+
* its producer token.
|
|
9
|
+
*
|
|
10
|
+
* Owner: decionis/Decionis, `packages/shared/src/outcomes/Evidence.ts`, generated to
|
|
11
|
+
* `packages/shared/contracts/OutcomeEvidence.v1.json` (owner revision e264bfbf5, source digest
|
|
12
|
+
* 865c60e2…). The exact bytes are vendored at `packages/agentsafe/contracts/OutcomeEvidence.v1.json`
|
|
13
|
+
* and pinned by {@link OUTCOME_EVIDENCE_CONTRACT_SHA256}: a test fails when the copy drifts, and
|
|
14
|
+
* holds every submission this package builds to the vendored schema.
|
|
15
|
+
*/
|
|
16
|
+
export declare const OUTCOME_EVIDENCE_VERSION: "decionis.outcomes.evidence/1";
|
|
17
|
+
export declare const OUTCOME_SUBMISSION_VERSION: "decionis.outcomes.submission/1";
|
|
18
|
+
export declare const OUTCOME_EVIDENCE_LIMITS: {
|
|
19
|
+
readonly batch: 1000;
|
|
20
|
+
readonly reasons: 30;
|
|
21
|
+
readonly exclusions: 10;
|
|
22
|
+
};
|
|
23
|
+
/** SHA-256 of the vendored owner bytes (`packages/agentsafe/contracts/OutcomeEvidence.v1.json`). */
|
|
24
|
+
export declare const OUTCOME_EVIDENCE_CONTRACT_SHA256 = "488c42003adce72cadfd6096586ebdb1c4bb79801e796810da78000bdded3d5b";
|
|
25
|
+
export declare const OUTCOME_CODE: RegExp;
|
|
26
|
+
/** Integer minor units in the transaction currency at its own scale; never converted. */
|
|
27
|
+
export declare const OutcomeMoneySchema: z.ZodObject<{
|
|
28
|
+
currency: z.ZodString;
|
|
29
|
+
scale: z.ZodNumber;
|
|
30
|
+
amount_minor: z.ZodNumber;
|
|
31
|
+
}, z.core.$strict>;
|
|
32
|
+
/**
|
|
33
|
+
* One business action, normalized by its producer. A later revision of the same subject
|
|
34
|
+
* supersedes the earlier one; business identifiers never leave AgentSafe, only digests. The
|
|
35
|
+
* three cross-field rules are Core's, and the JSON Schema cannot state them: governed evidence
|
|
36
|
+
* names its decision, only a held or blocked action is reviewed, and the financial result stays
|
|
37
|
+
* in the transaction currency.
|
|
38
|
+
*/
|
|
39
|
+
export declare const OutcomeEvidenceSchema: z.ZodObject<{
|
|
40
|
+
version: z.ZodLiteral<"decionis.outcomes.evidence/1">;
|
|
41
|
+
subject_digest: z.ZodString;
|
|
42
|
+
revision: z.ZodNumber;
|
|
43
|
+
platform: z.ZodString;
|
|
44
|
+
connection_id: z.ZodNullable<z.ZodString>;
|
|
45
|
+
action_type: z.ZodString;
|
|
46
|
+
occurred_at: z.ZodString;
|
|
47
|
+
amount: z.ZodObject<{
|
|
48
|
+
currency: z.ZodString;
|
|
49
|
+
scale: z.ZodNumber;
|
|
50
|
+
amount_minor: z.ZodNumber;
|
|
51
|
+
}, z.core.$strict>;
|
|
52
|
+
coverage: z.ZodEnum<{
|
|
53
|
+
UNGOVERNED: "UNGOVERNED";
|
|
54
|
+
OBSERVED: "OBSERVED";
|
|
55
|
+
GOVERNED: "GOVERNED";
|
|
56
|
+
}>;
|
|
57
|
+
decision: z.ZodNullable<z.ZodObject<{
|
|
58
|
+
decision_id: z.ZodNullable<z.ZodString>;
|
|
59
|
+
dossier_id: z.ZodNullable<z.ZodString>;
|
|
60
|
+
disposition: z.ZodEnum<{
|
|
61
|
+
BLOCK: "BLOCK";
|
|
62
|
+
HOLD: "HOLD";
|
|
63
|
+
PROCEED: "PROCEED";
|
|
64
|
+
}>;
|
|
65
|
+
mode: z.ZodEnum<{
|
|
66
|
+
SHADOW: "SHADOW";
|
|
67
|
+
ENFORCEMENT: "ENFORCEMENT";
|
|
68
|
+
PARALLEL: "PARALLEL";
|
|
69
|
+
}>;
|
|
70
|
+
decided_at: z.ZodString;
|
|
71
|
+
reason_codes: z.ZodArray<z.ZodString>;
|
|
72
|
+
}, z.core.$strict>>;
|
|
73
|
+
review: z.ZodNullable<z.ZodObject<{
|
|
74
|
+
case_id: z.ZodString;
|
|
75
|
+
outcome: z.ZodEnum<{
|
|
76
|
+
REJECTED: "REJECTED";
|
|
77
|
+
RELEASED: "RELEASED";
|
|
78
|
+
}>;
|
|
79
|
+
confirmation: z.ZodEnum<{
|
|
80
|
+
UNCONFIRMED: "UNCONFIRMED";
|
|
81
|
+
CONFIRMED_PROBLEM: "CONFIRMED_PROBLEM";
|
|
82
|
+
LEGITIMATE: "LEGITIMATE";
|
|
83
|
+
}>;
|
|
84
|
+
confirmed_by: z.ZodNullable<z.ZodEnum<{
|
|
85
|
+
REVIEWER: "REVIEWER";
|
|
86
|
+
CUSTOMER: "CUSTOMER";
|
|
87
|
+
}>>;
|
|
88
|
+
reviewer: z.ZodEnum<{
|
|
89
|
+
CUSTOMER: "CUSTOMER";
|
|
90
|
+
DESK: "DESK";
|
|
91
|
+
}>;
|
|
92
|
+
decided_at: z.ZodString;
|
|
93
|
+
analyst_minutes: z.ZodNullable<z.ZodNumber>;
|
|
94
|
+
}, z.core.$strict>>;
|
|
95
|
+
execution: z.ZodNullable<z.ZodObject<{
|
|
96
|
+
status: z.ZodEnum<{
|
|
97
|
+
COMMITTED: "COMMITTED";
|
|
98
|
+
FAILED: "FAILED";
|
|
99
|
+
UNKNOWN: "UNKNOWN";
|
|
100
|
+
NOT_EXECUTED: "NOT_EXECUTED";
|
|
101
|
+
}>;
|
|
102
|
+
grant_id: z.ZodNullable<z.ZodString>;
|
|
103
|
+
receipt_sha256: z.ZodNullable<z.ZodString>;
|
|
104
|
+
at: z.ZodString;
|
|
105
|
+
}, z.core.$strict>>;
|
|
106
|
+
financial: z.ZodNullable<z.ZodObject<{
|
|
107
|
+
status: z.ZodEnum<{
|
|
108
|
+
PENDING: "PENDING";
|
|
109
|
+
REVERSED: "REVERSED";
|
|
110
|
+
UNKNOWN: "UNKNOWN";
|
|
111
|
+
SETTLED: "SETTLED";
|
|
112
|
+
}>;
|
|
113
|
+
amount: z.ZodObject<{
|
|
114
|
+
currency: z.ZodString;
|
|
115
|
+
scale: z.ZodNumber;
|
|
116
|
+
amount_minor: z.ZodNumber;
|
|
117
|
+
}, z.core.$strict>;
|
|
118
|
+
at: z.ZodString;
|
|
119
|
+
}, z.core.$strict>>;
|
|
120
|
+
exclusion_codes: z.ZodArray<z.ZodString>;
|
|
121
|
+
source_sha256: z.ZodString;
|
|
122
|
+
}, z.core.$strict>;
|
|
123
|
+
/**
|
|
124
|
+
* `POST /v1/outcomes/evidence`: the producer token names the producer, the body names the
|
|
125
|
+
* organization it observed. One revision per subject in a batch, as Core holds it.
|
|
126
|
+
*/
|
|
127
|
+
export declare const OutcomeEvidenceSubmissionSchema: z.ZodObject<{
|
|
128
|
+
version: z.ZodLiteral<"decionis.outcomes.submission/1">;
|
|
129
|
+
producer: z.ZodEnum<{
|
|
130
|
+
agentsafe: "agentsafe";
|
|
131
|
+
commerce: "commerce";
|
|
132
|
+
}>;
|
|
133
|
+
org_id: z.ZodString;
|
|
134
|
+
evidence: z.ZodArray<z.ZodObject<{
|
|
135
|
+
version: z.ZodLiteral<"decionis.outcomes.evidence/1">;
|
|
136
|
+
subject_digest: z.ZodString;
|
|
137
|
+
revision: z.ZodNumber;
|
|
138
|
+
platform: z.ZodString;
|
|
139
|
+
connection_id: z.ZodNullable<z.ZodString>;
|
|
140
|
+
action_type: z.ZodString;
|
|
141
|
+
occurred_at: z.ZodString;
|
|
142
|
+
amount: z.ZodObject<{
|
|
143
|
+
currency: z.ZodString;
|
|
144
|
+
scale: z.ZodNumber;
|
|
145
|
+
amount_minor: z.ZodNumber;
|
|
146
|
+
}, z.core.$strict>;
|
|
147
|
+
coverage: z.ZodEnum<{
|
|
148
|
+
UNGOVERNED: "UNGOVERNED";
|
|
149
|
+
OBSERVED: "OBSERVED";
|
|
150
|
+
GOVERNED: "GOVERNED";
|
|
151
|
+
}>;
|
|
152
|
+
decision: z.ZodNullable<z.ZodObject<{
|
|
153
|
+
decision_id: z.ZodNullable<z.ZodString>;
|
|
154
|
+
dossier_id: z.ZodNullable<z.ZodString>;
|
|
155
|
+
disposition: z.ZodEnum<{
|
|
156
|
+
BLOCK: "BLOCK";
|
|
157
|
+
HOLD: "HOLD";
|
|
158
|
+
PROCEED: "PROCEED";
|
|
159
|
+
}>;
|
|
160
|
+
mode: z.ZodEnum<{
|
|
161
|
+
SHADOW: "SHADOW";
|
|
162
|
+
ENFORCEMENT: "ENFORCEMENT";
|
|
163
|
+
PARALLEL: "PARALLEL";
|
|
164
|
+
}>;
|
|
165
|
+
decided_at: z.ZodString;
|
|
166
|
+
reason_codes: z.ZodArray<z.ZodString>;
|
|
167
|
+
}, z.core.$strict>>;
|
|
168
|
+
review: z.ZodNullable<z.ZodObject<{
|
|
169
|
+
case_id: z.ZodString;
|
|
170
|
+
outcome: z.ZodEnum<{
|
|
171
|
+
REJECTED: "REJECTED";
|
|
172
|
+
RELEASED: "RELEASED";
|
|
173
|
+
}>;
|
|
174
|
+
confirmation: z.ZodEnum<{
|
|
175
|
+
UNCONFIRMED: "UNCONFIRMED";
|
|
176
|
+
CONFIRMED_PROBLEM: "CONFIRMED_PROBLEM";
|
|
177
|
+
LEGITIMATE: "LEGITIMATE";
|
|
178
|
+
}>;
|
|
179
|
+
confirmed_by: z.ZodNullable<z.ZodEnum<{
|
|
180
|
+
REVIEWER: "REVIEWER";
|
|
181
|
+
CUSTOMER: "CUSTOMER";
|
|
182
|
+
}>>;
|
|
183
|
+
reviewer: z.ZodEnum<{
|
|
184
|
+
CUSTOMER: "CUSTOMER";
|
|
185
|
+
DESK: "DESK";
|
|
186
|
+
}>;
|
|
187
|
+
decided_at: z.ZodString;
|
|
188
|
+
analyst_minutes: z.ZodNullable<z.ZodNumber>;
|
|
189
|
+
}, z.core.$strict>>;
|
|
190
|
+
execution: z.ZodNullable<z.ZodObject<{
|
|
191
|
+
status: z.ZodEnum<{
|
|
192
|
+
COMMITTED: "COMMITTED";
|
|
193
|
+
FAILED: "FAILED";
|
|
194
|
+
UNKNOWN: "UNKNOWN";
|
|
195
|
+
NOT_EXECUTED: "NOT_EXECUTED";
|
|
196
|
+
}>;
|
|
197
|
+
grant_id: z.ZodNullable<z.ZodString>;
|
|
198
|
+
receipt_sha256: z.ZodNullable<z.ZodString>;
|
|
199
|
+
at: z.ZodString;
|
|
200
|
+
}, z.core.$strict>>;
|
|
201
|
+
financial: z.ZodNullable<z.ZodObject<{
|
|
202
|
+
status: z.ZodEnum<{
|
|
203
|
+
PENDING: "PENDING";
|
|
204
|
+
REVERSED: "REVERSED";
|
|
205
|
+
UNKNOWN: "UNKNOWN";
|
|
206
|
+
SETTLED: "SETTLED";
|
|
207
|
+
}>;
|
|
208
|
+
amount: z.ZodObject<{
|
|
209
|
+
currency: z.ZodString;
|
|
210
|
+
scale: z.ZodNumber;
|
|
211
|
+
amount_minor: z.ZodNumber;
|
|
212
|
+
}, z.core.$strict>;
|
|
213
|
+
at: z.ZodString;
|
|
214
|
+
}, z.core.$strict>>;
|
|
215
|
+
exclusion_codes: z.ZodArray<z.ZodString>;
|
|
216
|
+
source_sha256: z.ZodString;
|
|
217
|
+
}, z.core.$strict>>;
|
|
218
|
+
}, z.core.$strict>;
|
|
219
|
+
export type OutcomeMoney = z.infer<typeof OutcomeMoneySchema>;
|
|
220
|
+
export type OutcomeEvidence = z.infer<typeof OutcomeEvidenceSchema>;
|
|
221
|
+
export type OutcomeDecision = NonNullable<OutcomeEvidence["decision"]>;
|
|
222
|
+
export type OutcomeReview = NonNullable<OutcomeEvidence["review"]>;
|
|
223
|
+
export type OutcomeExecution = NonNullable<OutcomeEvidence["execution"]>;
|
|
224
|
+
export type OutcomeEvidenceSubmission = z.infer<typeof OutcomeEvidenceSubmissionSchema>;
|
|
225
|
+
/**
|
|
226
|
+
* What the producer states about one subject. The revision is not the producer's to choose:
|
|
227
|
+
* the store assigns it from what it last recorded for the subject, so a subject's revision
|
|
228
|
+
* rises exactly when its evidence changes.
|
|
229
|
+
*/
|
|
230
|
+
export type OutcomeEvidenceDraft = Omit<OutcomeEvidence, "revision">;
|
|
231
|
+
/** Whether a string is a digest in the contract's form: 64 lowercase hex characters. */
|
|
232
|
+
export declare function isOutcomeDigest(value: unknown): value is string;
|
|
233
|
+
/**
|
|
234
|
+
* The contract's digest: SHA-256 over the RFC 8785 canonical form, as 64 lowercase hex
|
|
235
|
+
* characters with no prefix. The canonicaliser is the one every other digest here uses.
|
|
236
|
+
*/
|
|
237
|
+
export declare function outcomeDigest(value: JsonValue): string;
|
|
238
|
+
//# sourceMappingURL=OutcomeEvidence.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"OutcomeEvidence.d.ts","sourceRoot":"","sources":["../../src/outcomes/OutcomeEvidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,EAAG,8BAAuC,CAAC;AAChF,eAAO,MAAM,0BAA0B,EAAG,gCAAyC,CAAC;AACpF,eAAO,MAAM,uBAAuB;;;;CAAwD,CAAC;AAC7F,oGAAoG;AACpG,eAAO,MAAM,gCAAgC,qEACuB,CAAC;AAIrE,eAAO,MAAM,YAAY,QAA4B,CAAC;AAKtD,yFAAyF;AACzF,eAAO,MAAM,kBAAkB;;;;kBAI7B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmE9B,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYzC,CAAC;AAEJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnE,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;AACzE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;AAErE,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEtD"}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { jcsDigest } from "../adapters/JcsDigest.js";
|
|
3
|
+
/**
|
|
4
|
+
* Core's outcome evidence wire contract (`decionis.outcomes.evidence/1`, inside
|
|
5
|
+
* `decionis.outcomes.submission/1`), mirrored here. Core owns the meter: the signed agreement,
|
|
6
|
+
* the one `OutcomeCalculator` that classifies, the append-only ledger and the signed monthly
|
|
7
|
+
* statement. AgentSafe only states what it recorded about its card purchases and submits it with
|
|
8
|
+
* its producer token.
|
|
9
|
+
*
|
|
10
|
+
* Owner: decionis/Decionis, `packages/shared/src/outcomes/Evidence.ts`, generated to
|
|
11
|
+
* `packages/shared/contracts/OutcomeEvidence.v1.json` (owner revision e264bfbf5, source digest
|
|
12
|
+
* 865c60e2…). The exact bytes are vendored at `packages/agentsafe/contracts/OutcomeEvidence.v1.json`
|
|
13
|
+
* and pinned by {@link OUTCOME_EVIDENCE_CONTRACT_SHA256}: a test fails when the copy drifts, and
|
|
14
|
+
* holds every submission this package builds to the vendored schema.
|
|
15
|
+
*/
|
|
16
|
+
export const OUTCOME_EVIDENCE_VERSION = "decionis.outcomes.evidence/1";
|
|
17
|
+
export const OUTCOME_SUBMISSION_VERSION = "decionis.outcomes.submission/1";
|
|
18
|
+
export const OUTCOME_EVIDENCE_LIMITS = { batch: 1000, reasons: 30, exclusions: 10 };
|
|
19
|
+
/** SHA-256 of the vendored owner bytes (`packages/agentsafe/contracts/OutcomeEvidence.v1.json`). */
|
|
20
|
+
export const OUTCOME_EVIDENCE_CONTRACT_SHA256 = "488c42003adce72cadfd6096586ebdb1c4bb79801e796810da78000bdded3d5b";
|
|
21
|
+
const HEX = /^[a-f0-9]{64}$/;
|
|
22
|
+
const hex = z.string().regex(HEX);
|
|
23
|
+
export const OUTCOME_CODE = /^[A-Z][A-Z0-9_]{0,119}$/;
|
|
24
|
+
const code = z.string().regex(OUTCOME_CODE);
|
|
25
|
+
const instant = z.string().datetime({ offset: true }).max(40);
|
|
26
|
+
const uuid = z.string().uuid();
|
|
27
|
+
/** Integer minor units in the transaction currency at its own scale; never converted. */
|
|
28
|
+
export const OutcomeMoneySchema = z.strictObject({
|
|
29
|
+
currency: z.string().regex(/^[A-Z]{3}$/),
|
|
30
|
+
scale: z.number().int().min(0).max(6),
|
|
31
|
+
amount_minor: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
|
|
32
|
+
});
|
|
33
|
+
/**
|
|
34
|
+
* One business action, normalized by its producer. A later revision of the same subject
|
|
35
|
+
* supersedes the earlier one; business identifiers never leave AgentSafe, only digests. The
|
|
36
|
+
* three cross-field rules are Core's, and the JSON Schema cannot state them: governed evidence
|
|
37
|
+
* names its decision, only a held or blocked action is reviewed, and the financial result stays
|
|
38
|
+
* in the transaction currency.
|
|
39
|
+
*/
|
|
40
|
+
export const OutcomeEvidenceSchema = z
|
|
41
|
+
.strictObject({
|
|
42
|
+
version: z.literal(OUTCOME_EVIDENCE_VERSION),
|
|
43
|
+
subject_digest: hex,
|
|
44
|
+
revision: z.number().int().min(1).max(10_000),
|
|
45
|
+
platform: z.string().regex(/^[a-z0-9][a-z0-9-]{0,99}$/),
|
|
46
|
+
connection_id: uuid.nullable(),
|
|
47
|
+
action_type: code,
|
|
48
|
+
occurred_at: instant,
|
|
49
|
+
amount: OutcomeMoneySchema,
|
|
50
|
+
coverage: z.enum(["GOVERNED", "UNGOVERNED", "OBSERVED"]),
|
|
51
|
+
decision: z
|
|
52
|
+
.strictObject({
|
|
53
|
+
decision_id: z.string().min(1).max(120).nullable(),
|
|
54
|
+
dossier_id: z.string().min(1).max(200).nullable(),
|
|
55
|
+
disposition: z.enum(["PROCEED", "HOLD", "BLOCK"]),
|
|
56
|
+
mode: z.enum(["SHADOW", "PARALLEL", "ENFORCEMENT"]),
|
|
57
|
+
decided_at: instant,
|
|
58
|
+
reason_codes: z.array(code).max(OUTCOME_EVIDENCE_LIMITS.reasons),
|
|
59
|
+
})
|
|
60
|
+
.nullable(),
|
|
61
|
+
review: z
|
|
62
|
+
.strictObject({
|
|
63
|
+
case_id: z.string().min(1).max(200),
|
|
64
|
+
outcome: z.enum(["RELEASED", "REJECTED"]),
|
|
65
|
+
confirmation: z.enum(["CONFIRMED_PROBLEM", "LEGITIMATE", "UNCONFIRMED"]),
|
|
66
|
+
confirmed_by: z.enum(["REVIEWER", "CUSTOMER"]).nullable(),
|
|
67
|
+
reviewer: z.enum(["DESK", "CUSTOMER"]),
|
|
68
|
+
decided_at: instant,
|
|
69
|
+
analyst_minutes: z.number().int().min(0).max(10_000).nullable(),
|
|
70
|
+
})
|
|
71
|
+
.nullable(),
|
|
72
|
+
execution: z
|
|
73
|
+
.strictObject({
|
|
74
|
+
status: z.enum(["COMMITTED", "FAILED", "NOT_EXECUTED", "UNKNOWN"]),
|
|
75
|
+
grant_id: uuid.nullable(),
|
|
76
|
+
receipt_sha256: hex.nullable(),
|
|
77
|
+
at: instant,
|
|
78
|
+
})
|
|
79
|
+
.nullable(),
|
|
80
|
+
financial: z
|
|
81
|
+
.strictObject({
|
|
82
|
+
status: z.enum(["SETTLED", "REVERSED", "PENDING", "UNKNOWN"]),
|
|
83
|
+
amount: OutcomeMoneySchema,
|
|
84
|
+
at: instant,
|
|
85
|
+
})
|
|
86
|
+
.nullable(),
|
|
87
|
+
exclusion_codes: z.array(code).max(OUTCOME_EVIDENCE_LIMITS.exclusions),
|
|
88
|
+
source_sha256: hex,
|
|
89
|
+
})
|
|
90
|
+
.superRefine((evidence, context) => {
|
|
91
|
+
if (evidence.coverage === "GOVERNED" && evidence.decision === null) {
|
|
92
|
+
context.addIssue({ code: "custom", path: ["decision"], message: "OUTCOME_DECISION_MISSING" });
|
|
93
|
+
}
|
|
94
|
+
if (evidence.review !== null && evidence.decision?.disposition === "PROCEED") {
|
|
95
|
+
context.addIssue({ code: "custom", path: ["review"], message: "OUTCOME_REVIEW_OF_PROCEED" });
|
|
96
|
+
}
|
|
97
|
+
if (evidence.financial !== null &&
|
|
98
|
+
evidence.financial.amount.currency !== evidence.amount.currency) {
|
|
99
|
+
context.addIssue({
|
|
100
|
+
code: "custom",
|
|
101
|
+
path: ["financial", "amount"],
|
|
102
|
+
message: "OUTCOME_FINANCIAL_CURRENCY",
|
|
103
|
+
});
|
|
104
|
+
}
|
|
105
|
+
});
|
|
106
|
+
/**
|
|
107
|
+
* `POST /v1/outcomes/evidence`: the producer token names the producer, the body names the
|
|
108
|
+
* organization it observed. One revision per subject in a batch, as Core holds it.
|
|
109
|
+
*/
|
|
110
|
+
export const OutcomeEvidenceSubmissionSchema = z
|
|
111
|
+
.strictObject({
|
|
112
|
+
version: z.literal(OUTCOME_SUBMISSION_VERSION),
|
|
113
|
+
producer: z.enum(["commerce", "agentsafe"]),
|
|
114
|
+
org_id: uuid,
|
|
115
|
+
evidence: z.array(OutcomeEvidenceSchema).min(1).max(OUTCOME_EVIDENCE_LIMITS.batch),
|
|
116
|
+
})
|
|
117
|
+
.refine((submission) => new Set(submission.evidence.map((item) => item.subject_digest)).size ===
|
|
118
|
+
submission.evidence.length, { message: "OUTCOME_SUBJECT_REPEATED", path: ["evidence"] });
|
|
119
|
+
/** Whether a string is a digest in the contract's form: 64 lowercase hex characters. */
|
|
120
|
+
export function isOutcomeDigest(value) {
|
|
121
|
+
return typeof value === "string" && HEX.test(value);
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* The contract's digest: SHA-256 over the RFC 8785 canonical form, as 64 lowercase hex
|
|
125
|
+
* characters with no prefix. The canonicaliser is the one every other digest here uses.
|
|
126
|
+
*/
|
|
127
|
+
export function outcomeDigest(value) {
|
|
128
|
+
return jcsDigest(value).slice("sha256:".length);
|
|
129
|
+
}
|
|
130
|
+
//# sourceMappingURL=OutcomeEvidence.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"OutcomeEvidence.js","sourceRoot":"","sources":["../../src/outcomes/OutcomeEvidence.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import type { CardOutcomeEvidenceProvider } from "./CardOutcomeEvidence.js";
|
|
2
|
+
import type { CardOutcomeLedger } from "./CardOutcomeLedger.js";
|
|
3
|
+
import { type OutcomeEvidenceSink } from "./CoreOutcomeEvidenceClient.js";
|
|
4
|
+
import type { OutcomeEvidenceStore } from "./OutcomeEvidenceStore.js";
|
|
5
|
+
/**
|
|
6
|
+
* How far back a run reads facts. A card purchase's facts all arrive within its intent's
|
|
7
|
+
* lifetime and the claim's lease, minutes after its decision; three days covers that with room
|
|
8
|
+
* for a publisher that was down, and owed evidence is kept in the store until Core takes it.
|
|
9
|
+
*/
|
|
10
|
+
export declare const OUTCOME_LOOKBACK_DAYS = 3;
|
|
11
|
+
/** What one run did, in counts and codes: what the security stream and the tests read. */
|
|
12
|
+
export interface OutcomePublishSummary {
|
|
13
|
+
collected: number;
|
|
14
|
+
recorded: number;
|
|
15
|
+
unchanged: number;
|
|
16
|
+
exhausted: number;
|
|
17
|
+
invalid: number;
|
|
18
|
+
submitted: number;
|
|
19
|
+
accepted: number;
|
|
20
|
+
duplicates: number;
|
|
21
|
+
conflicts: number;
|
|
22
|
+
/** A refusal that stopped the run: Core's, the store's or the ledger's code; null when none. */
|
|
23
|
+
refused: string | null;
|
|
24
|
+
/** Whether the refusal is one a later run may get past (Core unreachable, for one). */
|
|
25
|
+
retry: boolean;
|
|
26
|
+
}
|
|
27
|
+
export interface OutcomeEvidencePublisherOptions {
|
|
28
|
+
readonly ledger: CardOutcomeLedger;
|
|
29
|
+
readonly provider: CardOutcomeEvidenceProvider;
|
|
30
|
+
readonly store: OutcomeEvidenceStore;
|
|
31
|
+
readonly sink: OutcomeEvidenceSink;
|
|
32
|
+
/** The Decionis organization the evidence is about. */
|
|
33
|
+
readonly orgId: string;
|
|
34
|
+
/** How often a run starts while nothing is owed or refused. */
|
|
35
|
+
readonly intervalMs: number;
|
|
36
|
+
/** Told what each run did; never awaited, and a throw is ignored. */
|
|
37
|
+
readonly report?: (summary: OutcomePublishSummary) => void;
|
|
38
|
+
readonly clock?: () => Date;
|
|
39
|
+
/** At most the contract's 1000. */
|
|
40
|
+
readonly batchSize?: number;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Feeds Core's outcome meter with the card purchases' evidence, after the fact and off the
|
|
44
|
+
* request path: a timer this process runs, never an authorization. A run reads the recorded
|
|
45
|
+
* facts, states each purchase through the producer, records a subject at a new revision only
|
|
46
|
+
* when its evidence changed, then sends what Core has not accepted, at most a thousand subjects
|
|
47
|
+
* per request. Nothing unchanged is ever sent again, so a run is idempotent and a restart
|
|
48
|
+
* resends nothing Core already holds. Core alone classifies and calculates.
|
|
49
|
+
*
|
|
50
|
+
* Core refuses a batch whole. A revision conflict (Core holds that revision with other content)
|
|
51
|
+
* moves the subject to its next revision and the batch goes again; a refusal the same batch
|
|
52
|
+
* cannot pass (a producer Core does not allow, evidence it refuses) stops the run until the next
|
|
53
|
+
* interval with the evidence still owed; an outage is retried sooner, backing off. A run never
|
|
54
|
+
* throws, and only one runs at a time.
|
|
55
|
+
*/
|
|
56
|
+
export declare class OutcomeEvidencePublisher {
|
|
57
|
+
private readonly options;
|
|
58
|
+
private readonly clock;
|
|
59
|
+
private readonly batchSize;
|
|
60
|
+
private running;
|
|
61
|
+
private timer;
|
|
62
|
+
private failures;
|
|
63
|
+
private stopped;
|
|
64
|
+
constructor(options: OutcomeEvidencePublisherOptions);
|
|
65
|
+
/** Runs now, then every interval, sooner after an outage; the timer never holds the process open. */
|
|
66
|
+
start(): void;
|
|
67
|
+
stop(): void;
|
|
68
|
+
/** One run; a run already under way is joined rather than doubled. */
|
|
69
|
+
publish(): Promise<OutcomePublishSummary>;
|
|
70
|
+
private schedule;
|
|
71
|
+
/** The interval, or after an outage a shorter wait that grows fourfold and never exceeds it. */
|
|
72
|
+
private nextDelay;
|
|
73
|
+
private run;
|
|
74
|
+
/** States every purchase in the window and records what changed. */
|
|
75
|
+
private sync;
|
|
76
|
+
/** Sends what Core has not accepted, a batch at a time; Core's acceptance marks each revision sent. */
|
|
77
|
+
private submit;
|
|
78
|
+
/** A failure's own code when it carries one in the outcome vocabulary; a generic one otherwise. */
|
|
79
|
+
private static code;
|
|
80
|
+
}
|
|
81
|
+
//# sourceMappingURL=OutcomeEvidencePublisher.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"OutcomeEvidencePublisher.d.ts","sourceRoot":"","sources":["../../src/outcomes/OutcomeEvidencePublisher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAQlG,OAAO,KAAK,EAAwB,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAE5F;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AASvC,0FAA0F;AAC1F,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uFAAuF;IACvF,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAwB;IAQhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAQ;gBAEa,OAAO,EAAE,+BAA+B;IAY5E,qGAAqG;IAC9F,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAMnB,sEAAsE;IACzD,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAOtD,OAAO,CAAC,QAAQ;IAYhB,gGAAgG;IAChG,OAAO,CAAC,SAAS;YAMH,GAAG;IA6BjB,oEAAoE;YACtD,IAAI;IAqBlB,uGAAuG;YACzF,MAAM;IAsCpB,mGAAmG;IACnG,OAAO,CAAC,MAAM,CAAC,IAAI;CAMpB"}
|