@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,361 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The report of an acceptance run, `agent-safe.acceptance/1`: what the
|
|
3
|
+
* gateway observed of the writes a plan named, what the agent's zone reported
|
|
4
|
+
* of its own routes, the fingerprint both were observed under, and the fixed
|
|
5
|
+
* list of what no run establishes
|
|
6
|
+
* ([ADR 0009](../../../../docs/architecture/decisions/0009-acceptance-run-on-named-targets.md)).
|
|
7
|
+
*
|
|
8
|
+
* The gateway signs it with a key of its own, which signs nothing else. The
|
|
9
|
+
* signature carries the gateway's word for what the gateway observed, and only
|
|
10
|
+
* the zone's word for what the zone reported: every case says which. A report
|
|
11
|
+
* establishes the named writes, targets and window, under one fingerprint;
|
|
12
|
+
* it does not carry over to other adapters, routes or environments.
|
|
13
|
+
*/
|
|
14
|
+
import { createHash, createPrivateKey, createPublicKey } from "node:crypto";
|
|
15
|
+
import { JsonObjectSchema, Rfc8785 } from "@decionis/agent-safe-pipeline";
|
|
16
|
+
import { z } from "zod";
|
|
17
|
+
import { zoneFindingsSchema } from "./ZoneProbes.js";
|
|
18
|
+
export const ACCEPTANCE_REPORT_VERSION = "agent-safe.acceptance/1";
|
|
19
|
+
/** The JWS `typ` of an acceptance report. */
|
|
20
|
+
export const ACCEPTANCE_REPORT_TYPE = "agent-safe-acceptance+jwt";
|
|
21
|
+
/** What a report says of its own reach, in every report. */
|
|
22
|
+
export const ACCEPTANCE_SCOPE = "This report establishes the named writes, targets, origins and window, under the fingerprint it carries, and nothing else. It does not carry over to other adapters, routes or environments.";
|
|
23
|
+
/** What no run establishes, and why, in every report. */
|
|
24
|
+
export const STATED_NOT_RUN = [
|
|
25
|
+
{
|
|
26
|
+
case: "grants_after_issuance",
|
|
27
|
+
reason: "The agent's zone never holds a grant, so it has none to alter, replay or carry to another boundary; the zone's credential scan is what reports what it does hold. The authority's and the provider's refusals of an altered, replayed or misdirected grant are established by the build: the Changed Conditions Test, the Compromised Principal Test and the provider conformance vectors.",
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
case: "lost_outcome_and_restart",
|
|
31
|
+
reason: "Established by the build's trusted-executor proof, not by a run.",
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
case: "downstream_consequences",
|
|
35
|
+
reason: "No record establishes what a confirmed effect leads to.",
|
|
36
|
+
},
|
|
37
|
+
{
|
|
38
|
+
case: "executor_host_integrity",
|
|
39
|
+
reason: "No record establishes that the host running the boundary is the one deployed.",
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
case: "node_and_kernel_isolation",
|
|
43
|
+
reason: "No record establishes the isolation the platform under the boundary provides.",
|
|
44
|
+
},
|
|
45
|
+
];
|
|
46
|
+
const identifier = z.string().min(1).max(200);
|
|
47
|
+
const sha256 = z.string().regex(/^sha256:[0-9a-f]{64}$/);
|
|
48
|
+
const codes = z.array(z.string().min(1).max(120)).max(32);
|
|
49
|
+
const status = z.number().int().min(100).max(599).nullable();
|
|
50
|
+
const verdict = z.enum(["ALLOW", "BLOCK", "ESCALATE"]).nullable();
|
|
51
|
+
const method = z.enum(["POST", "PUT", "PATCH", "DELETE"]);
|
|
52
|
+
const target = z.string().min(1).max(2_000);
|
|
53
|
+
/** One chained line the gateway wrote for a case, by its place in its stream. */
|
|
54
|
+
const LineSchema = z.strictObject({
|
|
55
|
+
stream: identifier,
|
|
56
|
+
seq: z.number().int().positive(),
|
|
57
|
+
hash: sha256,
|
|
58
|
+
event: identifier,
|
|
59
|
+
});
|
|
60
|
+
/** What the gateway did with one request it governed, as it reported it. */
|
|
61
|
+
const GovernedSchema = z.strictObject({
|
|
62
|
+
/** The upstream's answer, when the write reached it. */
|
|
63
|
+
upstream_status: status,
|
|
64
|
+
state: z.string().min(1).max(40).nullable(),
|
|
65
|
+
verdict,
|
|
66
|
+
execution: z.string().min(1).max(40).nullable(),
|
|
67
|
+
intent_id: identifier.nullable(),
|
|
68
|
+
decision_id: identifier.nullable(),
|
|
69
|
+
dossier_id: identifier.nullable(),
|
|
70
|
+
reason_codes: codes,
|
|
71
|
+
});
|
|
72
|
+
const PermittedSchema = z.strictObject({
|
|
73
|
+
name: identifier,
|
|
74
|
+
method,
|
|
75
|
+
path: target,
|
|
76
|
+
action: identifier.nullable(),
|
|
77
|
+
observed_by: z.literal("GATEWAY"),
|
|
78
|
+
...GovernedSchema.shape,
|
|
79
|
+
effect: z
|
|
80
|
+
.strictObject({
|
|
81
|
+
confirmation: z.enum(["CONFIRMED", "UNKNOWN", "PENDING"]),
|
|
82
|
+
reason_codes: codes,
|
|
83
|
+
})
|
|
84
|
+
.nullable(),
|
|
85
|
+
lines: z.array(LineSchema).max(16),
|
|
86
|
+
passed: z.boolean(),
|
|
87
|
+
failure: z.string().min(1).max(80).nullable(),
|
|
88
|
+
});
|
|
89
|
+
const ObservationSchema = z.strictObject({
|
|
90
|
+
outcome: z.enum(["UNCHANGED", "CHANGED", "UNREADABLE"]),
|
|
91
|
+
version_before: z.string().max(300).nullable(),
|
|
92
|
+
version_after: z.string().max(300).nullable(),
|
|
93
|
+
read_before_at: z.string().max(40).nullable(),
|
|
94
|
+
read_after_at: z.string().max(40).nullable(),
|
|
95
|
+
});
|
|
96
|
+
const ProhibitedSchema = z.strictObject({
|
|
97
|
+
name: identifier,
|
|
98
|
+
method,
|
|
99
|
+
path: target,
|
|
100
|
+
action: identifier.nullable(),
|
|
101
|
+
canary: z.string().min(1).max(300),
|
|
102
|
+
observed_by: z.literal("GATEWAY"),
|
|
103
|
+
shadow: z.strictObject({
|
|
104
|
+
verdict,
|
|
105
|
+
reason_codes: codes,
|
|
106
|
+
decision_id: identifier.nullable(),
|
|
107
|
+
dossier_id: identifier.nullable(),
|
|
108
|
+
}),
|
|
109
|
+
sent: z.boolean(),
|
|
110
|
+
...GovernedSchema.shape,
|
|
111
|
+
observation: ObservationSchema.nullable(),
|
|
112
|
+
lines: z.array(LineSchema).max(16),
|
|
113
|
+
passed: z.boolean(),
|
|
114
|
+
failure: z.string().min(1).max(80).nullable(),
|
|
115
|
+
});
|
|
116
|
+
const OutageSchema = z.strictObject({
|
|
117
|
+
name: identifier,
|
|
118
|
+
method,
|
|
119
|
+
path: target,
|
|
120
|
+
action: identifier.nullable(),
|
|
121
|
+
observed_by: z.literal("GATEWAY"),
|
|
122
|
+
/** Why the case did not run, or null when it ran. */
|
|
123
|
+
skipped: z.enum(["FAIL_OPEN"]).nullable(),
|
|
124
|
+
status,
|
|
125
|
+
execution: z.string().min(1).max(40).nullable(),
|
|
126
|
+
reason_codes: codes,
|
|
127
|
+
/** Writes that reached the second gateway's recording upstream: none, to pass. */
|
|
128
|
+
upstream_writes: z.number().int().nonnegative(),
|
|
129
|
+
passed: z.boolean(),
|
|
130
|
+
failure: z.string().min(1).max(80).nullable(),
|
|
131
|
+
});
|
|
132
|
+
const RouteSchema = z.strictObject({
|
|
133
|
+
methods: z.array(z.string().min(1).max(10)).min(1).max(8),
|
|
134
|
+
path: target,
|
|
135
|
+
action: identifier.nullable(),
|
|
136
|
+
});
|
|
137
|
+
/** Which of the gateway's routes the authority decides, and which it does not, by kind. */
|
|
138
|
+
export const CoverageSchema = z.strictObject({
|
|
139
|
+
governed: z
|
|
140
|
+
.array(RouteSchema.extend({
|
|
141
|
+
/** Whether a write here is read at its target, so its effect and a refusal can be observed. */
|
|
142
|
+
target_read: z.boolean(),
|
|
143
|
+
}))
|
|
144
|
+
.max(512),
|
|
145
|
+
ungoverned: z
|
|
146
|
+
.array(RouteSchema.extend({ kind: z.enum(["SHADOW", "FAIL_OPEN", "PASSTHROUGH"]) }))
|
|
147
|
+
.max(512),
|
|
148
|
+
/** Routes the gateway refuses outright, with nothing asked. */
|
|
149
|
+
refused: z.array(RouteSchema).max(512),
|
|
150
|
+
/** What happens to a read: relayed unchecked, checked against the profile, or refused unless known. */
|
|
151
|
+
reads: z.enum(["PASSTHROUGH", "CHECK", "REFUSE_UNKNOWN"]),
|
|
152
|
+
});
|
|
153
|
+
export const AcceptanceReportSchema = z.strictObject({
|
|
154
|
+
report: z.literal(ACCEPTANCE_REPORT_VERSION),
|
|
155
|
+
run_id: identifier,
|
|
156
|
+
boundary_id: identifier,
|
|
157
|
+
issued_at: z.string().datetime(),
|
|
158
|
+
expires_at: z.string().datetime(),
|
|
159
|
+
plan_digest: sha256,
|
|
160
|
+
fingerprint: z.strictObject({ digest: sha256, document: JsonObjectSchema }),
|
|
161
|
+
coverage: CoverageSchema,
|
|
162
|
+
permitted: z.array(PermittedSchema).max(16),
|
|
163
|
+
prohibited: z.array(ProhibitedSchema).max(16),
|
|
164
|
+
outage: z.array(OutageSchema).max(32),
|
|
165
|
+
zone: zoneFindingsSchema,
|
|
166
|
+
stated: z
|
|
167
|
+
.array(z.strictObject({ case: identifier, reason: z.string().min(1).max(1_000) }))
|
|
168
|
+
.max(16),
|
|
169
|
+
verdict: z.enum(["ACCEPTED", "NOT_ACCEPTED"]),
|
|
170
|
+
failures: z
|
|
171
|
+
.array(z.strictObject({ case: identifier, name: identifier, code: identifier }))
|
|
172
|
+
.max(128),
|
|
173
|
+
scope: z.literal(ACCEPTANCE_SCOPE),
|
|
174
|
+
});
|
|
175
|
+
/**
|
|
176
|
+
* Whether a permitted write went as the plan says it should: allowed,
|
|
177
|
+
* forwarded once, answered `2xx`, and not read back as something else. A
|
|
178
|
+
* write whose effect was not read passes as `PENDING`, which says so.
|
|
179
|
+
*/
|
|
180
|
+
export function judgePermitted(outcome, effect) {
|
|
181
|
+
if (outcome.verdict !== "ALLOW") {
|
|
182
|
+
return { passed: false, failure: outcome.verdict === null ? "NOT_DECIDED" : "NOT_ALLOWED" };
|
|
183
|
+
}
|
|
184
|
+
if (outcome.execution !== "FORWARDED")
|
|
185
|
+
return { passed: false, failure: "NOT_FORWARDED" };
|
|
186
|
+
const status = outcome.upstream_status ?? 0;
|
|
187
|
+
if (status < 200 || status > 299) {
|
|
188
|
+
return { passed: false, failure: "UPSTREAM_REFUSED" };
|
|
189
|
+
}
|
|
190
|
+
if (effect?.confirmation === "UNKNOWN")
|
|
191
|
+
return { passed: false, failure: "EFFECT_MISMATCH" };
|
|
192
|
+
return { passed: true, failure: null };
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* Whether a prohibited write was refused and its target read unchanged
|
|
196
|
+
* after: decided BLOCK or ESCALATE in shadow, sent, refused in enforcement,
|
|
197
|
+
* and observed `UNCHANGED`. Anything less fails, and says how.
|
|
198
|
+
*/
|
|
199
|
+
export function judgeProhibited(input) {
|
|
200
|
+
if (input.shadow === null)
|
|
201
|
+
return { passed: false, failure: "SHADOW_UNDECIDED" };
|
|
202
|
+
if (input.shadow === "ALLOW")
|
|
203
|
+
return { passed: false, failure: "SHADOW_ALLOWED" };
|
|
204
|
+
if (!input.sent)
|
|
205
|
+
return { passed: false, failure: "NOT_SENT" };
|
|
206
|
+
if (input.outcome.execution === "FORWARDED" || input.outcome.verdict === "ALLOW") {
|
|
207
|
+
return { passed: false, failure: "FORWARDED" };
|
|
208
|
+
}
|
|
209
|
+
if (input.observation === null)
|
|
210
|
+
return { passed: false, failure: "TARGET_NOT_OBSERVED" };
|
|
211
|
+
if (input.observation.outcome === "CHANGED") {
|
|
212
|
+
return { passed: false, failure: "TARGET_CHANGED" };
|
|
213
|
+
}
|
|
214
|
+
if (input.observation.outcome === "UNREADABLE") {
|
|
215
|
+
return { passed: false, failure: "TARGET_UNREADABLE" };
|
|
216
|
+
}
|
|
217
|
+
return { passed: true, failure: null };
|
|
218
|
+
}
|
|
219
|
+
/** Whether the second gateway refused with the authority down and sent nothing on. */
|
|
220
|
+
export function judgeOutage(input) {
|
|
221
|
+
if (input.upstreamWrites > 0)
|
|
222
|
+
return { passed: false, failure: "UPSTREAM_WRITTEN" };
|
|
223
|
+
if (input.status !== 503 || input.execution !== "NOT_FORWARDED") {
|
|
224
|
+
return { passed: false, failure: "NOT_FAIL_CLOSED" };
|
|
225
|
+
}
|
|
226
|
+
return { passed: true, failure: null };
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
* The zone's findings that fail a run, by case and name. An origin passes
|
|
230
|
+
* only `CONTAINED`; a provider only when it refused both writes; the metadata
|
|
231
|
+
* endpoint, when probed, only when it did not answer. Reachable MCP servers
|
|
232
|
+
* and the credentials found are listed, not judged: what the zone may hold is
|
|
233
|
+
* the operator's to say.
|
|
234
|
+
*/
|
|
235
|
+
export function zoneFailures(zone) {
|
|
236
|
+
const failures = [];
|
|
237
|
+
for (const origin of zone.origins) {
|
|
238
|
+
if (origin.verdict !== "CONTAINED") {
|
|
239
|
+
failures.push({ case: "origin", name: origin.name, code: origin.verdict });
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
for (const provider of zone.providers) {
|
|
243
|
+
if (provider.verdict !== "REFUSED") {
|
|
244
|
+
failures.push({ case: "provider", name: provider.name, code: provider.verdict });
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
if (zone.metadata !== null && zone.metadata.verdict === "REACHABLE") {
|
|
248
|
+
failures.push({ case: "metadata", name: "metadata", code: "REACHABLE" });
|
|
249
|
+
}
|
|
250
|
+
return failures;
|
|
251
|
+
}
|
|
252
|
+
/** The run's verdict: accepted only when every case that ran passed. */
|
|
253
|
+
export function acceptanceVerdict(cases) {
|
|
254
|
+
const failures = [
|
|
255
|
+
...cases.permitted.map((item) => ({ case: "permitted", item })),
|
|
256
|
+
...cases.prohibited.map((item) => ({ case: "prohibited", item })),
|
|
257
|
+
...cases.outage.map((item) => ({ case: "outage", item })),
|
|
258
|
+
]
|
|
259
|
+
.filter(({ item }) => !item.passed)
|
|
260
|
+
.map(({ case: kind, item }) => ({
|
|
261
|
+
case: kind,
|
|
262
|
+
name: item.name,
|
|
263
|
+
code: item.failure ?? "FAILED",
|
|
264
|
+
}));
|
|
265
|
+
failures.push(...zoneFailures(cases.zone));
|
|
266
|
+
return { verdict: failures.length === 0 ? "ACCEPTED" : "NOT_ACCEPTED", failures };
|
|
267
|
+
}
|
|
268
|
+
/** `sha256:` over a value's RFC 8785 form. */
|
|
269
|
+
export function canonicalDigest(value) {
|
|
270
|
+
return `sha256:${createHash("sha256").update(Rfc8785.stringify(value)).digest("hex")}`;
|
|
271
|
+
}
|
|
272
|
+
/** `sha256:` over the report as signed, the compact JWS's own bytes. */
|
|
273
|
+
export function reportDigest(token) {
|
|
274
|
+
return `sha256:${createHash("sha256").update(token).digest("hex")}`;
|
|
275
|
+
}
|
|
276
|
+
/**
|
|
277
|
+
* Reads a PKCS#8 PEM Ed25519 key. The `kid` is the one configured, or the
|
|
278
|
+
* key's RFC 7638 thumbprint, so the same key always has the same id.
|
|
279
|
+
*/
|
|
280
|
+
export function acceptanceSigningKey(pem, kid) {
|
|
281
|
+
const privateKey = createPrivateKey(pem);
|
|
282
|
+
if (privateKey.asymmetricKeyType !== "ed25519")
|
|
283
|
+
throw new Error("ACCEPTANCE_KEY_NOT_ED25519");
|
|
284
|
+
const jwk = createPublicKey(privateKey).export({ format: "jwk" });
|
|
285
|
+
const publicJwk = { kty: "OKP", crv: "Ed25519", x: String(jwk.x) };
|
|
286
|
+
const thumbprint = createHash("sha256")
|
|
287
|
+
.update(JSON.stringify({ crv: publicJwk.crv, kty: publicJwk.kty, x: publicJwk.x }))
|
|
288
|
+
.digest("base64url");
|
|
289
|
+
return { kid: kid ?? thumbprint, privateKey, publicJwk };
|
|
290
|
+
}
|
|
291
|
+
/** The compact JWS: `alg` EdDSA, `typ` the acceptance report's, `kid` the key's. */
|
|
292
|
+
export async function signAcceptanceReport(report, key) {
|
|
293
|
+
const { CompactSign } = await import("jose");
|
|
294
|
+
return await new CompactSign(new TextEncoder().encode(JSON.stringify(report)))
|
|
295
|
+
.setProtectedHeader({ alg: "EdDSA", typ: ACCEPTANCE_REPORT_TYPE, kid: key.kid })
|
|
296
|
+
.sign(key.privateKey);
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* Checks a report's signature against a public key, its shape against the
|
|
300
|
+
* schema, and that its fingerprint digest is the digest of the document it
|
|
301
|
+
* carries. It does not ask whether the deployment is still the one tested:
|
|
302
|
+
* that is a comparison with a running gateway, made apart from this.
|
|
303
|
+
*/
|
|
304
|
+
export async function readAcceptanceReport(token, publicJwk) {
|
|
305
|
+
const { compactVerify, decodeProtectedHeader, importJWK } = await import("jose");
|
|
306
|
+
let header;
|
|
307
|
+
try {
|
|
308
|
+
header = decodeProtectedHeader(token);
|
|
309
|
+
}
|
|
310
|
+
catch {
|
|
311
|
+
return { ok: false, code: "ACCEPTANCE_REPORT_MALFORMED" };
|
|
312
|
+
}
|
|
313
|
+
if (header.alg !== "EdDSA" ||
|
|
314
|
+
header.typ !== ACCEPTANCE_REPORT_TYPE ||
|
|
315
|
+
typeof header.kid !== "string") {
|
|
316
|
+
return { ok: false, code: "ACCEPTANCE_REPORT_MALFORMED" };
|
|
317
|
+
}
|
|
318
|
+
let payload;
|
|
319
|
+
try {
|
|
320
|
+
// The header named EdDSA above; the key is imported as nothing else.
|
|
321
|
+
const key = await importJWK(publicJwk, "EdDSA");
|
|
322
|
+
payload = (await compactVerify(token, key)).payload;
|
|
323
|
+
}
|
|
324
|
+
catch {
|
|
325
|
+
return { ok: false, code: "ACCEPTANCE_REPORT_SIGNATURE_INVALID" };
|
|
326
|
+
}
|
|
327
|
+
let parsed;
|
|
328
|
+
try {
|
|
329
|
+
parsed = AcceptanceReportSchema.safeParse(JSON.parse(new TextDecoder().decode(payload)));
|
|
330
|
+
}
|
|
331
|
+
catch {
|
|
332
|
+
return { ok: false, code: "ACCEPTANCE_REPORT_MALFORMED" };
|
|
333
|
+
}
|
|
334
|
+
if (!parsed.success)
|
|
335
|
+
return { ok: false, code: "ACCEPTANCE_REPORT_MALFORMED" };
|
|
336
|
+
const report = parsed.data;
|
|
337
|
+
if (canonicalDigest(report.fingerprint.document) !== report.fingerprint.digest) {
|
|
338
|
+
return { ok: false, code: "ACCEPTANCE_REPORT_INCONSISTENT" };
|
|
339
|
+
}
|
|
340
|
+
const judged = acceptanceVerdict(report);
|
|
341
|
+
if (judged.verdict !== report.verdict) {
|
|
342
|
+
return { ok: false, code: "ACCEPTANCE_REPORT_INCONSISTENT" };
|
|
343
|
+
}
|
|
344
|
+
return { ok: true, kid: header.kid, report };
|
|
345
|
+
}
|
|
346
|
+
/**
|
|
347
|
+
* Whether a report still describes a deployment: `EXPIRED` once its date
|
|
348
|
+
* has passed, `STALE` with the fingerprint fields that differ when the
|
|
349
|
+
* deployment is no longer the one tested, `CURRENT` otherwise. It changes
|
|
350
|
+
* nothing anywhere: a stale report is reported, never enforced.
|
|
351
|
+
*/
|
|
352
|
+
export function currency(report, running, now, changed) {
|
|
353
|
+
if (Date.parse(report.expires_at) <= now) {
|
|
354
|
+
return { state: "EXPIRED", expired_at: report.expires_at };
|
|
355
|
+
}
|
|
356
|
+
if (running.digest !== report.fingerprint.digest) {
|
|
357
|
+
return { state: "STALE", changed: changed(report.fingerprint.document, running.document) };
|
|
358
|
+
}
|
|
359
|
+
return { state: "CURRENT" };
|
|
360
|
+
}
|
|
361
|
+
//# sourceMappingURL=AcceptanceReport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AcceptanceReport.js","sourceRoot":"","sources":["../../src/acceptance/AcceptanceReport.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
import type { JsonValue } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import type { ChainFields } from "../audit/HashChain.js";
|
|
3
|
+
import type { DeploymentFingerprint } from "../posture/DeploymentFingerprint.js";
|
|
4
|
+
import type { InterceptionReport } from "../gateway/GatewayReport.js";
|
|
5
|
+
import { type PlanWrite } from "./AcceptancePlan.js";
|
|
6
|
+
import { type AcceptanceReport, type CaseLine, type Coverage } from "./AcceptanceReport.js";
|
|
7
|
+
/** The header a run's request carries: `<run id>:<write name>`. Never forwarded. */
|
|
8
|
+
export declare const ACCEPTANCE_RUN_HEADER = "agentsafe-acceptance-run";
|
|
9
|
+
/** How long a run stays open before it is discarded unsigned. */
|
|
10
|
+
export declare const RUN_TTL_MS: number;
|
|
11
|
+
/** The longest the close waits for the gateway's reports on what was sent. */
|
|
12
|
+
export declare const CLOSE_WAIT_MS = 30000;
|
|
13
|
+
/** How the gateway routes one write. */
|
|
14
|
+
export interface RouteFacts {
|
|
15
|
+
/** Decided by the authority in enforcement, failing closed or open. */
|
|
16
|
+
readonly enforced: boolean;
|
|
17
|
+
readonly action: string | null;
|
|
18
|
+
/** Whether the write's profile operation names a read of its target. */
|
|
19
|
+
readonly targetRead: boolean;
|
|
20
|
+
}
|
|
21
|
+
export interface ShadowOutcome {
|
|
22
|
+
readonly verdict: "ALLOW" | "BLOCK" | "ESCALATE" | null;
|
|
23
|
+
readonly reason_codes: readonly string[];
|
|
24
|
+
readonly decision_id: string | null;
|
|
25
|
+
readonly dossier_id: string | null;
|
|
26
|
+
}
|
|
27
|
+
export interface OutageOutcome {
|
|
28
|
+
readonly status: number | null;
|
|
29
|
+
readonly execution: string | null;
|
|
30
|
+
readonly reason_codes: readonly string[];
|
|
31
|
+
/** Requests other than reads that reached the second gateway's recording upstream. */
|
|
32
|
+
readonly upstreamWrites: number;
|
|
33
|
+
}
|
|
34
|
+
/** What the gateway lends a run. */
|
|
35
|
+
export interface AcceptanceHost {
|
|
36
|
+
readonly boundaryId: string;
|
|
37
|
+
readonly fingerprint: DeploymentFingerprint;
|
|
38
|
+
readonly failurePolicy: "FAIL_CLOSED" | "FAIL_OPEN";
|
|
39
|
+
readonly coverage: Coverage;
|
|
40
|
+
route(write: PlanWrite): RouteFacts;
|
|
41
|
+
/** The write decided in shadow, captured as its route captures it; nothing read or forwarded. */
|
|
42
|
+
decide(write: PlanWrite): Promise<ShadowOutcome>;
|
|
43
|
+
/** The write through a second gateway whose authority is down and whose upstream records. */
|
|
44
|
+
outage(write: PlanWrite): Promise<OutageOutcome>;
|
|
45
|
+
/** Settles once every read after a refusal still due has been made. */
|
|
46
|
+
settled(): Promise<void>;
|
|
47
|
+
/** One line on the gateway's chain, and where it went. */
|
|
48
|
+
link(fields: ChainFields): CaseLine;
|
|
49
|
+
sign(report: AcceptanceReport): Promise<string>;
|
|
50
|
+
clock(): number;
|
|
51
|
+
}
|
|
52
|
+
/** What an endpoint answers. */
|
|
53
|
+
export interface RunAnswer {
|
|
54
|
+
readonly status: number;
|
|
55
|
+
readonly body: Readonly<Record<string, JsonValue>>;
|
|
56
|
+
}
|
|
57
|
+
/** A request carrying the run header: tracked as one write, refused, or the header absent. */
|
|
58
|
+
export type Admission = {
|
|
59
|
+
readonly kind: "NONE";
|
|
60
|
+
} | {
|
|
61
|
+
readonly kind: "REFUSE";
|
|
62
|
+
readonly code: string;
|
|
63
|
+
} | {
|
|
64
|
+
readonly kind: "TRACK";
|
|
65
|
+
readonly name: string;
|
|
66
|
+
};
|
|
67
|
+
export declare class AcceptanceRuns {
|
|
68
|
+
private readonly host;
|
|
69
|
+
private readonly random;
|
|
70
|
+
private run;
|
|
71
|
+
constructor(host: AcceptanceHost, random?: () => string);
|
|
72
|
+
/** The open run: none once its time is up, unless it is already closing. */
|
|
73
|
+
private current;
|
|
74
|
+
private named;
|
|
75
|
+
/**
|
|
76
|
+
* Opens a run for a plan, once the plan's writes are all writes this gateway
|
|
77
|
+
* decides in enforcement, and each prohibited one reads its target. A run
|
|
78
|
+
* already open refuses another until it closes or its time is up.
|
|
79
|
+
*/
|
|
80
|
+
open(body: unknown): RunAnswer;
|
|
81
|
+
/**
|
|
82
|
+
* A prohibited write the open run names, decided in shadow: nothing read,
|
|
83
|
+
* nothing forwarded, the decision on the chain. Only a write the plan names
|
|
84
|
+
* as prohibited is decided, once; the endpoint answers nothing else.
|
|
85
|
+
*/
|
|
86
|
+
decide(runId: string, name: string): Promise<RunAnswer>;
|
|
87
|
+
/**
|
|
88
|
+
* Whether a request carrying the run header is a write the open run names,
|
|
89
|
+
* sent as the plan wrote it, once, and, when prohibited, only after a shadow
|
|
90
|
+
* BLOCK or ESCALATE. Anything else carrying the header is refused before
|
|
91
|
+
* the authority is asked, so a run never sends what its plan did not name.
|
|
92
|
+
*/
|
|
93
|
+
admit(tag: string | undefined, request: {
|
|
94
|
+
readonly method: string;
|
|
95
|
+
readonly path: string;
|
|
96
|
+
readonly search: string;
|
|
97
|
+
readonly body: Buffer;
|
|
98
|
+
}): Admission;
|
|
99
|
+
/** The intent a tracked write was captured as. */
|
|
100
|
+
captured(name: string, intentId: string): void;
|
|
101
|
+
/** The gateway's answer to a tracked write, for one refused before it was captured. */
|
|
102
|
+
answered(name: string, state: string | null, execution: string | null): void;
|
|
103
|
+
/** What the gateway reported of a tracked write. */
|
|
104
|
+
intercepted(report: InterceptionReport): void;
|
|
105
|
+
/** A line the gateway chained about a tracked write. */
|
|
106
|
+
linked(fields: ChainFields, line: CaseLine): void;
|
|
107
|
+
/**
|
|
108
|
+
* Closes the run: the zone's findings taken as reported, the outage case
|
|
109
|
+
* run on the second gateway, every read after a refusal awaited, the report
|
|
110
|
+
* assembled from what the gateway observed, signed, and its digest chained.
|
|
111
|
+
*/
|
|
112
|
+
close(runId: string, findings: unknown): Promise<RunAnswer>;
|
|
113
|
+
private outcomeOf;
|
|
114
|
+
private permittedCase;
|
|
115
|
+
private prohibitedCase;
|
|
116
|
+
private outageCase;
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=AcceptanceRun.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AcceptanceRun.d.ts","sourceRoot":"","sources":["../../src/acceptance/AcceptanceRun.ts"],"names":[],"mappings":"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"}
|