@decionis/agentsafe 0.1.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/LICENSE +202 -0
- package/NOTICE +4 -0
- package/README.md +909 -0
- package/dist/Cli.d.ts +3 -0
- package/dist/Cli.d.ts.map +1 -0
- package/dist/Cli.js +150 -0
- package/dist/Cli.js.map +1 -0
- package/dist/Index.d.ts +104 -0
- package/dist/Index.d.ts.map +1 -0
- package/dist/Index.js +102 -0
- package/dist/Index.js.map +1 -0
- package/dist/Serve.d.ts +26 -0
- package/dist/Serve.d.ts.map +1 -0
- package/dist/Serve.js +143 -0
- package/dist/Serve.js.map +1 -0
- package/dist/TrustedExecutor.d.ts +66 -0
- package/dist/TrustedExecutor.d.ts.map +1 -0
- package/dist/TrustedExecutor.js +170 -0
- package/dist/TrustedExecutor.js.map +1 -0
- package/dist/Version.d.ts +6 -0
- package/dist/Version.d.ts.map +1 -0
- package/dist/Version.js +21 -0
- package/dist/Version.js.map +1 -0
- package/dist/adapters/AdapterActionHandler.d.ts +48 -0
- package/dist/adapters/AdapterActionHandler.d.ts.map +1 -0
- package/dist/adapters/AdapterActionHandler.js +148 -0
- package/dist/adapters/AdapterActionHandler.js.map +1 -0
- package/dist/adapters/EffectAdapter.d.ts +96 -0
- package/dist/adapters/EffectAdapter.d.ts.map +1 -0
- package/dist/adapters/EffectAdapter.js +16 -0
- package/dist/adapters/EffectAdapter.js.map +1 -0
- package/dist/adapters/EffectAwareGrantVerifier.d.ts +30 -0
- package/dist/adapters/EffectAwareGrantVerifier.d.ts.map +1 -0
- package/dist/adapters/EffectAwareGrantVerifier.js +38 -0
- package/dist/adapters/EffectAwareGrantVerifier.js.map +1 -0
- package/dist/adapters/EffectComparison.d.ts +20 -0
- package/dist/adapters/EffectComparison.d.ts.map +1 -0
- package/dist/adapters/EffectComparison.js +48 -0
- package/dist/adapters/EffectComparison.js.map +1 -0
- package/dist/adapters/EffectEvidenceBuilder.d.ts +60 -0
- package/dist/adapters/EffectEvidenceBuilder.d.ts.map +1 -0
- package/dist/adapters/EffectEvidenceBuilder.js +127 -0
- package/dist/adapters/EffectEvidenceBuilder.js.map +1 -0
- package/dist/adapters/EffectEvidenceRegister.d.ts +31 -0
- package/dist/adapters/EffectEvidenceRegister.d.ts.map +1 -0
- package/dist/adapters/EffectEvidenceRegister.js +21 -0
- package/dist/adapters/EffectEvidenceRegister.js.map +1 -0
- package/dist/adapters/JcsDigest.d.ts +43 -0
- package/dist/adapters/JcsDigest.d.ts.map +1 -0
- package/dist/adapters/JcsDigest.js +86 -0
- package/dist/adapters/JcsDigest.js.map +1 -0
- package/dist/adapters/banking/BankingAction.d.ts +146 -0
- package/dist/adapters/banking/BankingAction.d.ts.map +1 -0
- package/dist/adapters/banking/BankingAction.js +102 -0
- package/dist/adapters/banking/BankingAction.js.map +1 -0
- package/dist/adapters/banking/BankingAdapter.d.ts +60 -0
- package/dist/adapters/banking/BankingAdapter.d.ts.map +1 -0
- package/dist/adapters/banking/BankingAdapter.js +107 -0
- package/dist/adapters/banking/BankingAdapter.js.map +1 -0
- package/dist/adapters/banking/BankingHandlers.d.ts +24 -0
- package/dist/adapters/banking/BankingHandlers.d.ts.map +1 -0
- package/dist/adapters/banking/BankingHandlers.js +47 -0
- package/dist/adapters/banking/BankingHandlers.js.map +1 -0
- package/dist/adapters/banking/BankingIntentBinder.d.ts +47 -0
- package/dist/adapters/banking/BankingIntentBinder.d.ts.map +1 -0
- package/dist/adapters/banking/BankingIntentBinder.js +64 -0
- package/dist/adapters/banking/BankingIntentBinder.js.map +1 -0
- package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts +55 -0
- package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -0
- package/dist/adapters/banking/CoreBankingHttpAdapter.js +248 -0
- package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -0
- package/dist/adapters/banking/Currency.d.ts +10 -0
- package/dist/adapters/banking/Currency.d.ts.map +1 -0
- package/dist/adapters/banking/Currency.js +91 -0
- package/dist/adapters/banking/Currency.js.map +1 -0
- package/dist/adapters/banking/EffectProjections.d.ts +52 -0
- package/dist/adapters/banking/EffectProjections.d.ts.map +1 -0
- package/dist/adapters/banking/EffectProjections.js +140 -0
- package/dist/adapters/banking/EffectProjections.js.map +1 -0
- package/dist/adapters/banking/Iban.d.ts +18 -0
- package/dist/adapters/banking/Iban.d.ts.map +1 -0
- package/dist/adapters/banking/Iban.js +38 -0
- package/dist/adapters/banking/Iban.js.map +1 -0
- package/dist/adapters/banking/Money.d.ts +32 -0
- package/dist/adapters/banking/Money.d.ts.map +1 -0
- package/dist/adapters/banking/Money.js +81 -0
- package/dist/adapters/banking/Money.js.map +1 -0
- package/dist/adapters/banking/ReasonCodes.d.ts +19 -0
- package/dist/adapters/banking/ReasonCodes.d.ts.map +1 -0
- package/dist/adapters/banking/ReasonCodes.js +35 -0
- package/dist/adapters/banking/ReasonCodes.js.map +1 -0
- package/dist/audit/ChainJournal.d.ts +38 -0
- package/dist/audit/ChainJournal.d.ts.map +1 -0
- package/dist/audit/ChainJournal.js +97 -0
- package/dist/audit/ChainJournal.js.map +1 -0
- package/dist/audit/HashChain.d.ts +39 -0
- package/dist/audit/HashChain.d.ts.map +1 -0
- package/dist/audit/HashChain.js +63 -0
- package/dist/audit/HashChain.js.map +1 -0
- package/dist/audit/HashChainedAuditSink.d.ts +22 -0
- package/dist/audit/HashChainedAuditSink.d.ts.map +1 -0
- package/dist/audit/HashChainedAuditSink.js +26 -0
- package/dist/audit/HashChainedAuditSink.js.map +1 -0
- package/dist/audit/LineAuditSink.d.ts +19 -0
- package/dist/audit/LineAuditSink.d.ts.map +1 -0
- package/dist/audit/LineAuditSink.js +35 -0
- package/dist/audit/LineAuditSink.js.map +1 -0
- package/dist/cli/Arguments.d.ts +26 -0
- package/dist/cli/Arguments.d.ts.map +1 -0
- package/dist/cli/Arguments.js +66 -0
- package/dist/cli/Arguments.js.map +1 -0
- package/dist/cli/CliProcess.d.ts +29 -0
- package/dist/cli/CliProcess.d.ts.map +1 -0
- package/dist/cli/CliProcess.js +78 -0
- package/dist/cli/CliProcess.js.map +1 -0
- package/dist/cli/Commands.d.ts +8 -0
- package/dist/cli/Commands.d.ts.map +1 -0
- package/dist/cli/Commands.js +67 -0
- package/dist/cli/Commands.js.map +1 -0
- package/dist/cli/ConfigCommand.d.ts +7 -0
- package/dist/cli/ConfigCommand.d.ts.map +1 -0
- package/dist/cli/ConfigCommand.js +77 -0
- package/dist/cli/ConfigCommand.js.map +1 -0
- package/dist/cli/ConfigFile.d.ts +21 -0
- package/dist/cli/ConfigFile.d.ts.map +1 -0
- package/dist/cli/ConfigFile.js +57 -0
- package/dist/cli/ConfigFile.js.map +1 -0
- package/dist/cli/Credentials.d.ts +15 -0
- package/dist/cli/Credentials.d.ts.map +1 -0
- package/dist/cli/Credentials.js +51 -0
- package/dist/cli/Credentials.js.map +1 -0
- package/dist/cli/Doctor.d.ts +25 -0
- package/dist/cli/Doctor.d.ts.map +1 -0
- package/dist/cli/Doctor.js +211 -0
- package/dist/cli/Doctor.js.map +1 -0
- package/dist/cli/Help.d.ts +3 -0
- package/dist/cli/Help.d.ts.map +1 -0
- package/dist/cli/Help.js +38 -0
- package/dist/cli/Help.js.map +1 -0
- package/dist/cli/Init.d.ts +32 -0
- package/dist/cli/Init.d.ts.map +1 -0
- package/dist/cli/Init.js +163 -0
- package/dist/cli/Init.js.map +1 -0
- package/dist/cli/Login.d.ts +16 -0
- package/dist/cli/Login.d.ts.map +1 -0
- package/dist/cli/Login.js +74 -0
- package/dist/cli/Login.js.map +1 -0
- package/dist/cli/Proxy.d.ts +41 -0
- package/dist/cli/Proxy.d.ts.map +1 -0
- package/dist/cli/Proxy.js +161 -0
- package/dist/cli/Proxy.js.map +1 -0
- package/dist/cli/Status.d.ts +7 -0
- package/dist/cli/Status.d.ts.map +1 -0
- package/dist/cli/Status.js +64 -0
- package/dist/cli/Status.js.map +1 -0
- package/dist/cli/TestCommand.d.ts +36 -0
- package/dist/cli/TestCommand.d.ts.map +1 -0
- package/dist/cli/TestCommand.js +173 -0
- package/dist/cli/TestCommand.js.map +1 -0
- package/dist/config/ConfigKeys.d.ts +10 -0
- package/dist/config/ConfigKeys.d.ts.map +1 -0
- package/dist/config/ConfigKeys.js +105 -0
- package/dist/config/ConfigKeys.js.map +1 -0
- package/dist/config/ExecutorConfig.d.ts +254 -0
- package/dist/config/ExecutorConfig.d.ts.map +1 -0
- package/dist/config/ExecutorConfig.js +637 -0
- package/dist/config/ExecutorConfig.js.map +1 -0
- package/dist/containment/ContainmentProbe.d.ts +87 -0
- package/dist/containment/ContainmentProbe.d.ts.map +1 -0
- package/dist/containment/ContainmentProbe.js +103 -0
- package/dist/containment/ContainmentProbe.js.map +1 -0
- package/dist/credential/CredentialError.d.ts +6 -0
- package/dist/credential/CredentialError.d.ts.map +1 -0
- package/dist/credential/CredentialError.js +10 -0
- package/dist/credential/CredentialError.js.map +1 -0
- package/dist/credential/DownstreamCredential.d.ts +38 -0
- package/dist/credential/DownstreamCredential.d.ts.map +1 -0
- package/dist/credential/DownstreamCredential.js +2 -0
- package/dist/credential/DownstreamCredential.js.map +1 -0
- package/dist/credential/GrantOf.d.ts +10 -0
- package/dist/credential/GrantOf.d.ts.map +1 -0
- package/dist/credential/GrantOf.js +16 -0
- package/dist/credential/GrantOf.js.map +1 -0
- package/dist/credential/PrivateKeyJwtCredential.d.ts +43 -0
- package/dist/credential/PrivateKeyJwtCredential.d.ts.map +1 -0
- package/dist/credential/PrivateKeyJwtCredential.js +126 -0
- package/dist/credential/PrivateKeyJwtCredential.js.map +1 -0
- package/dist/credential/SignedRequestCredential.d.ts +112 -0
- package/dist/credential/SignedRequestCredential.d.ts.map +1 -0
- package/dist/credential/SignedRequestCredential.js +255 -0
- package/dist/credential/SignedRequestCredential.js.map +1 -0
- package/dist/credential/StaticHeaderCredential.d.ts +16 -0
- package/dist/credential/StaticHeaderCredential.d.ts.map +1 -0
- package/dist/credential/StaticHeaderCredential.js +21 -0
- package/dist/credential/StaticHeaderCredential.js.map +1 -0
- package/dist/egress/EgressError.d.ts +13 -0
- package/dist/egress/EgressError.d.ts.map +1 -0
- package/dist/egress/EgressError.js +16 -0
- package/dist/egress/EgressError.js.map +1 -0
- package/dist/egress/EgressPolicy.d.ts +55 -0
- package/dist/egress/EgressPolicy.d.ts.map +1 -0
- package/dist/egress/EgressPolicy.js +137 -0
- package/dist/egress/EgressPolicy.js.map +1 -0
- package/dist/egress/GlobalFetchLock.d.ts +16 -0
- package/dist/egress/GlobalFetchLock.d.ts.map +1 -0
- package/dist/egress/GlobalFetchLock.js +34 -0
- package/dist/egress/GlobalFetchLock.js.map +1 -0
- package/dist/egress/GuardedFetch.d.ts +56 -0
- package/dist/egress/GuardedFetch.d.ts.map +1 -0
- package/dist/egress/GuardedFetch.js +300 -0
- package/dist/egress/GuardedFetch.js.map +1 -0
- package/dist/egress/TcpProbe.d.ts +35 -0
- package/dist/egress/TcpProbe.d.ts.map +1 -0
- package/dist/egress/TcpProbe.js +45 -0
- package/dist/egress/TcpProbe.js.map +1 -0
- package/dist/gateway/Activation.d.ts +39 -0
- package/dist/gateway/Activation.d.ts.map +1 -0
- package/dist/gateway/Activation.js +61 -0
- package/dist/gateway/Activation.js.map +1 -0
- package/dist/gateway/BoundaryTest.d.ts +92 -0
- package/dist/gateway/BoundaryTest.d.ts.map +1 -0
- package/dist/gateway/BoundaryTest.js +349 -0
- package/dist/gateway/BoundaryTest.js.map +1 -0
- package/dist/gateway/DemoAuthority.d.ts +41 -0
- package/dist/gateway/DemoAuthority.d.ts.map +1 -0
- package/dist/gateway/DemoAuthority.js +66 -0
- package/dist/gateway/DemoAuthority.js.map +1 -0
- package/dist/gateway/ForwardHandler.d.ts +56 -0
- package/dist/gateway/ForwardHandler.d.ts.map +1 -0
- package/dist/gateway/ForwardHandler.js +111 -0
- package/dist/gateway/ForwardHandler.js.map +1 -0
- package/dist/gateway/Gateway.d.ts +142 -0
- package/dist/gateway/Gateway.d.ts.map +1 -0
- package/dist/gateway/Gateway.js +819 -0
- package/dist/gateway/Gateway.js.map +1 -0
- package/dist/gateway/GatewayConfig.d.ts +237 -0
- package/dist/gateway/GatewayConfig.d.ts.map +1 -0
- package/dist/gateway/GatewayConfig.js +706 -0
- package/dist/gateway/GatewayConfig.js.map +1 -0
- package/dist/gateway/GatewayMetrics.d.ts +26 -0
- package/dist/gateway/GatewayMetrics.d.ts.map +1 -0
- package/dist/gateway/GatewayMetrics.js +28 -0
- package/dist/gateway/GatewayMetrics.js.map +1 -0
- package/dist/gateway/GatewayReport.d.ts +74 -0
- package/dist/gateway/GatewayReport.d.ts.map +1 -0
- package/dist/gateway/GatewayReport.js +109 -0
- package/dist/gateway/GatewayReport.js.map +1 -0
- package/dist/gateway/InterceptedRequest.d.ts +53 -0
- package/dist/gateway/InterceptedRequest.d.ts.map +1 -0
- package/dist/gateway/InterceptedRequest.js +80 -0
- package/dist/gateway/InterceptedRequest.js.map +1 -0
- package/dist/gateway/RouteTable.d.ts +28 -0
- package/dist/gateway/RouteTable.d.ts.map +1 -0
- package/dist/gateway/RouteTable.js +72 -0
- package/dist/gateway/RouteTable.js.map +1 -0
- package/dist/gateway/Upstream.d.ts +46 -0
- package/dist/gateway/Upstream.d.ts.map +1 -0
- package/dist/gateway/Upstream.js +158 -0
- package/dist/gateway/Upstream.js.map +1 -0
- package/dist/handlers/ForwardRequestHandler.d.ts +26 -0
- package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -0
- package/dist/handlers/ForwardRequestHandler.js +98 -0
- package/dist/handlers/ForwardRequestHandler.js.map +1 -0
- package/dist/handlers/HandlerRegistration.d.ts +37 -0
- package/dist/handlers/HandlerRegistration.d.ts.map +1 -0
- package/dist/handlers/HandlerRegistration.js +2 -0
- package/dist/handlers/HandlerRegistration.js.map +1 -0
- package/dist/handlers/JournaledActionHandler.d.ts +31 -0
- package/dist/handlers/JournaledActionHandler.d.ts.map +1 -0
- package/dist/handlers/JournaledActionHandler.js +63 -0
- package/dist/handlers/JournaledActionHandler.js.map +1 -0
- package/dist/http/ExecutorHttpServer.d.ts +33 -0
- package/dist/http/ExecutorHttpServer.d.ts.map +1 -0
- package/dist/http/ExecutorHttpServer.js +176 -0
- package/dist/http/ExecutorHttpServer.js.map +1 -0
- package/dist/http/GatewayHttpServer.d.ts +42 -0
- package/dist/http/GatewayHttpServer.d.ts.map +1 -0
- package/dist/http/GatewayHttpServer.js +195 -0
- package/dist/http/GatewayHttpServer.js.map +1 -0
- package/dist/http/RecordingTarget.d.ts +18 -0
- package/dist/http/RecordingTarget.d.ts.map +1 -0
- package/dist/http/RecordingTarget.js +71 -0
- package/dist/http/RecordingTarget.js.map +1 -0
- package/dist/http/RequestContext.d.ts +17 -0
- package/dist/http/RequestContext.d.ts.map +1 -0
- package/dist/http/RequestContext.js +19 -0
- package/dist/http/RequestContext.js.map +1 -0
- package/dist/http/Routes.d.ts +93 -0
- package/dist/http/Routes.d.ts.map +1 -0
- package/dist/http/Routes.js +46 -0
- package/dist/http/Routes.js.map +1 -0
- package/dist/http/TlsListener.d.ts +38 -0
- package/dist/http/TlsListener.d.ts.map +1 -0
- package/dist/http/TlsListener.js +52 -0
- package/dist/http/TlsListener.js.map +1 -0
- package/dist/identity/Authenticator.d.ts +58 -0
- package/dist/identity/Authenticator.d.ts.map +1 -0
- package/dist/identity/Authenticator.js +170 -0
- package/dist/identity/Authenticator.js.map +1 -0
- package/dist/identity/PeerIdentity.d.ts +24 -0
- package/dist/identity/PeerIdentity.d.ts.map +1 -0
- package/dist/identity/PeerIdentity.js +29 -0
- package/dist/identity/PeerIdentity.js.map +1 -0
- package/dist/identity/PrincipalRegistry.d.ts +102 -0
- package/dist/identity/PrincipalRegistry.d.ts.map +1 -0
- package/dist/identity/PrincipalRegistry.js +191 -0
- package/dist/identity/PrincipalRegistry.js.map +1 -0
- package/dist/identity/PrincipalsFile.d.ts +152 -0
- package/dist/identity/PrincipalsFile.d.ts.map +1 -0
- package/dist/identity/PrincipalsFile.js +125 -0
- package/dist/identity/PrincipalsFile.js.map +1 -0
- package/dist/identity/RateLimiter.d.ts +43 -0
- package/dist/identity/RateLimiter.d.ts.map +1 -0
- package/dist/identity/RateLimiter.js +84 -0
- package/dist/identity/RateLimiter.js.map +1 -0
- package/dist/identity/SeparationOfDuties.d.ts +11 -0
- package/dist/identity/SeparationOfDuties.d.ts.map +1 -0
- package/dist/identity/SeparationOfDuties.js +25 -0
- package/dist/identity/SeparationOfDuties.js.map +1 -0
- package/dist/identity/WorkloadJwtVerifier.d.ts +57 -0
- package/dist/identity/WorkloadJwtVerifier.d.ts.map +1 -0
- package/dist/identity/WorkloadJwtVerifier.js +145 -0
- package/dist/identity/WorkloadJwtVerifier.js.map +1 -0
- package/dist/incident/EvidenceExport.d.ts +128 -0
- package/dist/incident/EvidenceExport.d.ts.map +1 -0
- package/dist/incident/EvidenceExport.js +187 -0
- package/dist/incident/EvidenceExport.js.map +1 -0
- package/dist/incident/FileProbe.d.ts +22 -0
- package/dist/incident/FileProbe.d.ts.map +1 -0
- package/dist/incident/FileProbe.js +31 -0
- package/dist/incident/FileProbe.js.map +1 -0
- package/dist/incident/HaltSwitch.d.ts +95 -0
- package/dist/incident/HaltSwitch.d.ts.map +1 -0
- package/dist/incident/HaltSwitch.js +171 -0
- package/dist/incident/HaltSwitch.js.map +1 -0
- package/dist/incident/Metrics.d.ts +71 -0
- package/dist/incident/Metrics.d.ts.map +1 -0
- package/dist/incident/Metrics.js +146 -0
- package/dist/incident/Metrics.js.map +1 -0
- package/dist/incident/SecurityEvents.d.ts +182 -0
- package/dist/incident/SecurityEvents.d.ts.map +1 -0
- package/dist/incident/SecurityEvents.js +167 -0
- package/dist/incident/SecurityEvents.js.map +1 -0
- package/dist/journal/ExecutionJournal.d.ts +96 -0
- package/dist/journal/ExecutionJournal.d.ts.map +1 -0
- package/dist/journal/ExecutionJournal.js +100 -0
- package/dist/journal/ExecutionJournal.js.map +1 -0
- package/dist/journal/FileExecutionJournal.d.ts +38 -0
- package/dist/journal/FileExecutionJournal.d.ts.map +1 -0
- package/dist/journal/FileExecutionJournal.js +137 -0
- package/dist/journal/FileExecutionJournal.js.map +1 -0
- package/dist/journal/InMemoryExecutionJournal.d.ts +23 -0
- package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -0
- package/dist/journal/InMemoryExecutionJournal.js +47 -0
- package/dist/journal/InMemoryExecutionJournal.js.map +1 -0
- package/dist/journal/StartupReconciler.d.ts +47 -0
- package/dist/journal/StartupReconciler.d.ts.map +1 -0
- package/dist/journal/StartupReconciler.js +89 -0
- package/dist/journal/StartupReconciler.js.map +1 -0
- package/dist/limits/HardLimits.d.ts +63 -0
- package/dist/limits/HardLimits.d.ts.map +1 -0
- package/dist/limits/HardLimits.js +120 -0
- package/dist/limits/HardLimits.js.map +1 -0
- package/dist/logging/LineEmitter.d.ts +26 -0
- package/dist/logging/LineEmitter.d.ts.map +1 -0
- package/dist/logging/LineEmitter.js +36 -0
- package/dist/logging/LineEmitter.js.map +1 -0
- package/dist/posture/HostPosture.d.ts +60 -0
- package/dist/posture/HostPosture.d.ts.map +1 -0
- package/dist/posture/HostPosture.js +104 -0
- package/dist/posture/HostPosture.js.map +1 -0
- package/dist/posture/PostureChecks.d.ts +52 -0
- package/dist/posture/PostureChecks.d.ts.map +1 -0
- package/dist/posture/PostureChecks.js +172 -0
- package/dist/posture/PostureChecks.js.map +1 -0
- package/dist/secrets/CompositeSecretStore.d.ts +37 -0
- package/dist/secrets/CompositeSecretStore.d.ts.map +1 -0
- package/dist/secrets/CompositeSecretStore.js +99 -0
- package/dist/secrets/CompositeSecretStore.js.map +1 -0
- package/dist/secrets/EnvSecretStore.d.ts +18 -0
- package/dist/secrets/EnvSecretStore.d.ts.map +1 -0
- package/dist/secrets/EnvSecretStore.js +46 -0
- package/dist/secrets/EnvSecretStore.js.map +1 -0
- package/dist/secrets/FileSecretStore.d.ts +60 -0
- package/dist/secrets/FileSecretStore.d.ts.map +1 -0
- package/dist/secrets/FileSecretStore.js +180 -0
- package/dist/secrets/FileSecretStore.js.map +1 -0
- package/dist/secrets/Redactor.d.ts +32 -0
- package/dist/secrets/Redactor.d.ts.map +1 -0
- package/dist/secrets/Redactor.js +108 -0
- package/dist/secrets/Redactor.js.map +1 -0
- package/dist/secrets/SecretHandle.d.ts +34 -0
- package/dist/secrets/SecretHandle.d.ts.map +1 -0
- package/dist/secrets/SecretHandle.js +71 -0
- package/dist/secrets/SecretHandle.js.map +1 -0
- package/dist/secrets/SecretStore.d.ts +37 -0
- package/dist/secrets/SecretStore.d.ts.map +1 -0
- package/dist/secrets/SecretStore.js +12 -0
- package/dist/secrets/SecretStore.js.map +1 -0
- package/dist/service/AuthorityClients.d.ts +50 -0
- package/dist/service/AuthorityClients.d.ts.map +1 -0
- package/dist/service/AuthorityClients.js +83 -0
- package/dist/service/AuthorityClients.js.map +1 -0
- package/dist/service/EscalationResolver.d.ts +97 -0
- package/dist/service/EscalationResolver.d.ts.map +1 -0
- package/dist/service/EscalationResolver.js +196 -0
- package/dist/service/EscalationResolver.js.map +1 -0
- package/dist/service/Requests.d.ts +99 -0
- package/dist/service/Requests.d.ts.map +1 -0
- package/dist/service/Requests.js +42 -0
- package/dist/service/Requests.js.map +1 -0
- package/dist/service/ServiceError.d.ts +20 -0
- package/dist/service/ServiceError.d.ts.map +1 -0
- package/dist/service/ServiceError.js +25 -0
- package/dist/service/ServiceError.js.map +1 -0
- package/dist/service/TrustedExecutorService.d.ts +221 -0
- package/dist/service/TrustedExecutorService.d.ts.map +1 -0
- package/dist/service/TrustedExecutorService.js +1066 -0
- package/dist/service/TrustedExecutorService.js.map +1 -0
- package/dist/time/ClockSkewGuard.d.ts +25 -0
- package/dist/time/ClockSkewGuard.d.ts.map +1 -0
- package/dist/time/ClockSkewGuard.js +35 -0
- package/dist/time/ClockSkewGuard.js.map +1 -0
- package/dist/time/MonotonicClock.d.ts +35 -0
- package/dist/time/MonotonicClock.d.ts.map +1 -0
- package/dist/time/MonotonicClock.js +52 -0
- package/dist/time/MonotonicClock.js.map +1 -0
- package/dist/verify/VerifyAuditChain.d.ts +36 -0
- package/dist/verify/VerifyAuditChain.d.ts.map +1 -0
- package/dist/verify/VerifyAuditChain.js +109 -0
- package/dist/verify/VerifyAuditChain.js.map +1 -0
- package/dist/verify/VerifyEvidenceBundle.d.ts +50 -0
- package/dist/verify/VerifyEvidenceBundle.d.ts.map +1 -0
- package/dist/verify/VerifyEvidenceBundle.js +157 -0
- package/dist/verify/VerifyEvidenceBundle.js.map +1 -0
- package/package.json +80 -0
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export const JOURNAL_VERSION = "agent-safe.attempts/1";
|
|
3
|
+
const identifier = z.string().trim().min(1).max(200);
|
|
4
|
+
const hash = z.string().regex(/^sha256:[0-9a-f]{64}$/);
|
|
5
|
+
/**
|
|
6
|
+
* What the journal records about one attempt, in the order it happens:
|
|
7
|
+
* opened before the executor runs, claimed after the grant is consumed and
|
|
8
|
+
* before the provider is touched, closed once the outcome is known, and
|
|
9
|
+
* reconciled when a lost outcome is resolved later. The intent is stored
|
|
10
|
+
* whole on `ATTEMPT_OPENED`, because reconciliation needs the exact intent
|
|
11
|
+
* it was and nothing less will re-hash to the same value.
|
|
12
|
+
*/
|
|
13
|
+
export const JournalRecordSchema = z.discriminatedUnion("record", [
|
|
14
|
+
z.strictObject({
|
|
15
|
+
record: z.literal("ATTEMPT_OPENED"),
|
|
16
|
+
at: z.string().datetime(),
|
|
17
|
+
intent_id: identifier,
|
|
18
|
+
intent_hash: hash,
|
|
19
|
+
idempotency_key: z.string().trim().min(1).max(180),
|
|
20
|
+
decision_id: identifier,
|
|
21
|
+
dossier_id: identifier,
|
|
22
|
+
caller_principal: identifier.nullable(),
|
|
23
|
+
/** The captured intent, verbatim, so a restart can present it again. */
|
|
24
|
+
intent: z.record(z.string(), z.unknown()),
|
|
25
|
+
}),
|
|
26
|
+
z.strictObject({
|
|
27
|
+
record: z.literal("GRANT_CLAIMED"),
|
|
28
|
+
at: z.string().datetime(),
|
|
29
|
+
intent_id: identifier,
|
|
30
|
+
intent_hash: hash,
|
|
31
|
+
idempotency_key: z.string().trim().min(1).max(180),
|
|
32
|
+
grant_id: identifier,
|
|
33
|
+
expires_at: z.string().datetime(),
|
|
34
|
+
/** SHA-256 over the canonical parameters the handler is about to send. */
|
|
35
|
+
request_digest: hash,
|
|
36
|
+
}),
|
|
37
|
+
z.strictObject({
|
|
38
|
+
record: z.literal("ATTEMPT_CLOSED"),
|
|
39
|
+
at: z.string().datetime(),
|
|
40
|
+
intent_id: identifier,
|
|
41
|
+
intent_hash: hash,
|
|
42
|
+
outcome: z.string().trim().min(1).max(64),
|
|
43
|
+
executed: z.boolean().nullable(),
|
|
44
|
+
finalization: z.enum(["RECORDED", "PENDING", "UNSUPPORTED"]).nullable(),
|
|
45
|
+
}),
|
|
46
|
+
z.strictObject({
|
|
47
|
+
record: z.literal("RECONCILED"),
|
|
48
|
+
at: z.string().datetime(),
|
|
49
|
+
intent_id: identifier,
|
|
50
|
+
intent_hash: hash,
|
|
51
|
+
status: z.enum(["COMPLETED", "DEFINITELY_NOT_EXECUTED", "UNKNOWN_AFTER_DISPATCH", "BLOCKED"]),
|
|
52
|
+
source: z.enum(["STARTUP", "CALLER"]),
|
|
53
|
+
}),
|
|
54
|
+
]);
|
|
55
|
+
/** A refusal by the journal: the code, never a path or a value. */
|
|
56
|
+
export class JournalError extends Error {
|
|
57
|
+
code;
|
|
58
|
+
constructor(code) {
|
|
59
|
+
super(code);
|
|
60
|
+
this.code = code;
|
|
61
|
+
this.name = "JournalError";
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
/** Folds a stream of records into the attempts still open, oldest first. */
|
|
65
|
+
export function openAttemptsFrom(records) {
|
|
66
|
+
const open = new Map();
|
|
67
|
+
for (const record of records) {
|
|
68
|
+
if (record.record === "ATTEMPT_OPENED") {
|
|
69
|
+
open.set(record.intent_id, {
|
|
70
|
+
intentId: record.intent_id,
|
|
71
|
+
intentHash: record.intent_hash,
|
|
72
|
+
idempotencyKey: record.idempotency_key,
|
|
73
|
+
openedAt: record.at,
|
|
74
|
+
decisionId: record.decision_id,
|
|
75
|
+
dossierId: record.dossier_id,
|
|
76
|
+
grantId: null,
|
|
77
|
+
expiresAt: null,
|
|
78
|
+
callerPrincipal: record.caller_principal,
|
|
79
|
+
state: "OPENED",
|
|
80
|
+
intent: record.intent,
|
|
81
|
+
});
|
|
82
|
+
continue;
|
|
83
|
+
}
|
|
84
|
+
if (record.record === "GRANT_CLAIMED") {
|
|
85
|
+
const attempt = open.get(record.intent_id);
|
|
86
|
+
if (attempt !== undefined) {
|
|
87
|
+
open.set(record.intent_id, {
|
|
88
|
+
...attempt,
|
|
89
|
+
grantId: record.grant_id,
|
|
90
|
+
expiresAt: record.expires_at,
|
|
91
|
+
state: "CLAIMED",
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
continue;
|
|
95
|
+
}
|
|
96
|
+
open.delete(record.intent_id);
|
|
97
|
+
}
|
|
98
|
+
return [...open.values()];
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=ExecutionJournal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ExecutionJournal.js","sourceRoot":"","sources":["../../src/journal/ExecutionJournal.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { type ExecutionJournal, type JournalRecord, type OpenAttempt } from "./ExecutionJournal.js";
|
|
2
|
+
/** The most a single record may be, so one attempt cannot fill the volume. */
|
|
3
|
+
export declare const MAX_RECORD_BYTES: number;
|
|
4
|
+
export interface FileExecutionJournalOptions {
|
|
5
|
+
/** How many days of files to read back at start; older files are left alone. */
|
|
6
|
+
readonly retainDays?: number;
|
|
7
|
+
readonly clock?: () => Date;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* The journal as append-only JSONL, one file per UTC day, each record
|
|
11
|
+
* flushed to the device before the call returns: an attempt is on disk
|
|
12
|
+
* before the provider is touched, or the append throws and nothing is
|
|
13
|
+
* dispatched. The directory is created private to this process, a path that
|
|
14
|
+
* is not a regular file is refused, and a record larger than the bound is
|
|
15
|
+
* refused rather than truncated.
|
|
16
|
+
*
|
|
17
|
+
* What it is not: replicated. A pod that loses its volume loses its open
|
|
18
|
+
* attempts, which the deployment answers with a per-pod claim and the
|
|
19
|
+
* authority's own lease recovery.
|
|
20
|
+
*/
|
|
21
|
+
export declare class FileExecutionJournal implements ExecutionJournal {
|
|
22
|
+
private readonly directory;
|
|
23
|
+
private readonly clock;
|
|
24
|
+
private readonly retainDays;
|
|
25
|
+
private handle;
|
|
26
|
+
constructor(directory: string, options?: FileExecutionJournalOptions);
|
|
27
|
+
append(record: JournalRecord): Promise<void>;
|
|
28
|
+
openAttempts(): Promise<readonly OpenAttempt[]>;
|
|
29
|
+
close(): void;
|
|
30
|
+
/** Every record in the retained files, oldest day first; a line that is not one is skipped. */
|
|
31
|
+
private records;
|
|
32
|
+
/** The retained days present in the directory, oldest first. */
|
|
33
|
+
private days;
|
|
34
|
+
/** The day's file, opened for appending only, private to this process. */
|
|
35
|
+
private fileFor;
|
|
36
|
+
private static day;
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=FileExecutionJournal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FileExecutionJournal.d.ts","sourceRoot":"","sources":["../../src/journal/FileExecutionJournal.ts"],"names":[],"mappings":"AAYA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAE/B,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,QAAa,CAAC;AAG3C,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAMzD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAA8D;gBAGzD,SAAS,EAAE,MAAM,EAClC,OAAO,GAAE,2BAAgC;IAa9B,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,YAAY,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAIrD,KAAK,IAAI,IAAI;IAKpB,+FAA+F;IAC/F,OAAO,CAAC,OAAO;IAwBf,gEAAgE;IAChE,OAAO,CAAC,IAAI;IAeZ,0EAA0E;IAC1E,OAAO,CAAC,OAAO;IAuBf,OAAO,CAAC,MAAM,CAAC,GAAG;CAGnB"}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
import { closeSync, fstatSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, statSync, writeSync, } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { JournalError, JournalRecordSchema, openAttemptsFrom, } from "./ExecutionJournal.js";
|
|
4
|
+
/** The most a single record may be, so one attempt cannot fill the volume. */
|
|
5
|
+
export const MAX_RECORD_BYTES = 256 * 1024;
|
|
6
|
+
const FILE_PATTERN = /^attempts-(\d{4}-\d{2}-\d{2})\.jsonl$/;
|
|
7
|
+
/**
|
|
8
|
+
* The journal as append-only JSONL, one file per UTC day, each record
|
|
9
|
+
* flushed to the device before the call returns: an attempt is on disk
|
|
10
|
+
* before the provider is touched, or the append throws and nothing is
|
|
11
|
+
* dispatched. The directory is created private to this process, a path that
|
|
12
|
+
* is not a regular file is refused, and a record larger than the bound is
|
|
13
|
+
* refused rather than truncated.
|
|
14
|
+
*
|
|
15
|
+
* What it is not: replicated. A pod that loses its volume loses its open
|
|
16
|
+
* attempts, which the deployment answers with a per-pod claim and the
|
|
17
|
+
* authority's own lease recovery.
|
|
18
|
+
*/
|
|
19
|
+
export class FileExecutionJournal {
|
|
20
|
+
directory;
|
|
21
|
+
clock;
|
|
22
|
+
retainDays;
|
|
23
|
+
handle = null;
|
|
24
|
+
constructor(directory, options = {}) {
|
|
25
|
+
this.directory = directory;
|
|
26
|
+
this.clock = options.clock ?? (() => new Date());
|
|
27
|
+
this.retainDays = options.retainDays ?? 7;
|
|
28
|
+
try {
|
|
29
|
+
mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
30
|
+
const stat = statSync(directory);
|
|
31
|
+
if (!stat.isDirectory())
|
|
32
|
+
throw new Error("not a directory");
|
|
33
|
+
}
|
|
34
|
+
catch {
|
|
35
|
+
throw new JournalError("JOURNAL_DIRECTORY_UNUSABLE");
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
async append(record) {
|
|
39
|
+
const line = `${JSON.stringify(JournalRecordSchema.parse(record))}\n`;
|
|
40
|
+
const bytes = Buffer.from(line, "utf8");
|
|
41
|
+
if (bytes.byteLength > MAX_RECORD_BYTES)
|
|
42
|
+
throw new JournalError("JOURNAL_RECORD_TOO_LARGE");
|
|
43
|
+
const fd = this.fileFor(FileExecutionJournal.day(this.clock()));
|
|
44
|
+
try {
|
|
45
|
+
writeSync(fd, bytes);
|
|
46
|
+
fsyncSync(fd);
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
throw new JournalError("JOURNAL_WRITE_FAILED");
|
|
50
|
+
}
|
|
51
|
+
await Promise.resolve();
|
|
52
|
+
}
|
|
53
|
+
async openAttempts() {
|
|
54
|
+
return await Promise.resolve(openAttemptsFrom(this.records()));
|
|
55
|
+
}
|
|
56
|
+
close() {
|
|
57
|
+
if (this.handle !== null)
|
|
58
|
+
closeSync(this.handle.fd);
|
|
59
|
+
this.handle = null;
|
|
60
|
+
}
|
|
61
|
+
/** Every record in the retained files, oldest day first; a line that is not one is skipped. */
|
|
62
|
+
records() {
|
|
63
|
+
const records = [];
|
|
64
|
+
for (const day of this.days()) {
|
|
65
|
+
let text;
|
|
66
|
+
try {
|
|
67
|
+
text = readFileSync(join(this.directory, `attempts-${day}.jsonl`), "utf8");
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
continue;
|
|
71
|
+
}
|
|
72
|
+
for (const line of text.split("\n")) {
|
|
73
|
+
if (line.trim() === "")
|
|
74
|
+
continue;
|
|
75
|
+
let parsed;
|
|
76
|
+
try {
|
|
77
|
+
parsed = JSON.parse(line);
|
|
78
|
+
}
|
|
79
|
+
catch {
|
|
80
|
+
continue;
|
|
81
|
+
}
|
|
82
|
+
const record = JournalRecordSchema.safeParse(parsed);
|
|
83
|
+
if (record.success)
|
|
84
|
+
records.push(record.data);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
return records;
|
|
88
|
+
}
|
|
89
|
+
/** The retained days present in the directory, oldest first. */
|
|
90
|
+
days() {
|
|
91
|
+
const floor = new Date(this.clock().getTime() - this.retainDays * 86_400_000);
|
|
92
|
+
const earliest = FileExecutionJournal.day(floor);
|
|
93
|
+
let entries;
|
|
94
|
+
try {
|
|
95
|
+
entries = readdirSync(this.directory);
|
|
96
|
+
}
|
|
97
|
+
catch {
|
|
98
|
+
return [];
|
|
99
|
+
}
|
|
100
|
+
return entries
|
|
101
|
+
.map((entry) => FILE_PATTERN.exec(entry)?.[1])
|
|
102
|
+
.filter((day) => day !== undefined && day >= earliest)
|
|
103
|
+
.sort();
|
|
104
|
+
}
|
|
105
|
+
/** The day's file, opened for appending only, private to this process. */
|
|
106
|
+
fileFor(day) {
|
|
107
|
+
if (this.handle?.day === day)
|
|
108
|
+
return this.handle.fd;
|
|
109
|
+
if (this.handle !== null)
|
|
110
|
+
closeSync(this.handle.fd);
|
|
111
|
+
this.handle = null;
|
|
112
|
+
const path = join(this.directory, `attempts-${day}.jsonl`);
|
|
113
|
+
let fd;
|
|
114
|
+
try {
|
|
115
|
+
// "a" never follows a symlink into a file it would then append to
|
|
116
|
+
// without noticing: the descriptor is checked before anything is written.
|
|
117
|
+
fd = openSync(path, "a", 0o600);
|
|
118
|
+
}
|
|
119
|
+
catch {
|
|
120
|
+
throw new JournalError("JOURNAL_UNWRITABLE");
|
|
121
|
+
}
|
|
122
|
+
try {
|
|
123
|
+
if (!fstatSync(fd).isFile())
|
|
124
|
+
throw new Error("not a regular file");
|
|
125
|
+
}
|
|
126
|
+
catch {
|
|
127
|
+
closeSync(fd);
|
|
128
|
+
throw new JournalError("JOURNAL_NOT_A_FILE");
|
|
129
|
+
}
|
|
130
|
+
this.handle = { day, fd };
|
|
131
|
+
return fd;
|
|
132
|
+
}
|
|
133
|
+
static day(at) {
|
|
134
|
+
return at.toISOString().slice(0, 10);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
//# sourceMappingURL=FileExecutionJournal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FileExecutionJournal.js","sourceRoot":"","sources":["../../src/journal/FileExecutionJournal.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { openAttemptsFrom, type ExecutionJournal, type JournalRecord, type JournalRecordKind } from "./ExecutionJournal.js";
|
|
2
|
+
/**
|
|
3
|
+
* A journal that keeps its records in memory. It is honest about what it is:
|
|
4
|
+
* nothing survives the process, so a deployment that needs an attempt to
|
|
5
|
+
* outlive a restart configures `EXECUTOR_JOURNAL_DIR` and gets the file
|
|
6
|
+
* journal. This exists for shadow mode, for the offline proof, and for tests.
|
|
7
|
+
*/
|
|
8
|
+
export declare class InMemoryExecutionJournal implements ExecutionJournal {
|
|
9
|
+
private readonly records;
|
|
10
|
+
private failure;
|
|
11
|
+
private failingKind;
|
|
12
|
+
/** Makes the next append throw; for the tests that prove a claim is never lost. */
|
|
13
|
+
failNextAppend(code?: string): void;
|
|
14
|
+
/** Makes every append of one kind throw, until cleared with null. */
|
|
15
|
+
failEvery(kind: JournalRecordKind | null, code?: string): void;
|
|
16
|
+
/** Forgets every record, as a fresh process would; the failures stay as set. */
|
|
17
|
+
clear(): void;
|
|
18
|
+
get all(): readonly JournalRecord[];
|
|
19
|
+
append(record: JournalRecord): Promise<void>;
|
|
20
|
+
openAttempts(): Promise<ReturnType<typeof openAttemptsFrom>>;
|
|
21
|
+
close(): void;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=InMemoryExecutionJournal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"InMemoryExecutionJournal.d.ts","sourceRoot":"","sources":["../../src/journal/InMemoryExecutionJournal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAkC;IAErD,mFAAmF;IAC5E,cAAc,CAAC,IAAI,SAAyB,GAAG,IAAI;IAI1D,qEAAqE;IAC9D,SAAS,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,EAAE,IAAI,SAAyB,GAAG,IAAI;IAKrF,gFAAgF;IACzE,KAAK,IAAI,IAAI;IAIpB,IAAW,GAAG,IAAI,SAAS,aAAa,EAAE,CAEzC;IAEY,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAIlE,KAAK,IAAI,IAAI;CAGrB"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { openAttemptsFrom, } from "./ExecutionJournal.js";
|
|
2
|
+
/**
|
|
3
|
+
* A journal that keeps its records in memory. It is honest about what it is:
|
|
4
|
+
* nothing survives the process, so a deployment that needs an attempt to
|
|
5
|
+
* outlive a restart configures `EXECUTOR_JOURNAL_DIR` and gets the file
|
|
6
|
+
* journal. This exists for shadow mode, for the offline proof, and for tests.
|
|
7
|
+
*/
|
|
8
|
+
export class InMemoryExecutionJournal {
|
|
9
|
+
records = [];
|
|
10
|
+
failure = null;
|
|
11
|
+
failingKind = null;
|
|
12
|
+
/** Makes the next append throw; for the tests that prove a claim is never lost. */
|
|
13
|
+
failNextAppend(code = "JOURNAL_WRITE_FAILED") {
|
|
14
|
+
this.failure = code;
|
|
15
|
+
}
|
|
16
|
+
/** Makes every append of one kind throw, until cleared with null. */
|
|
17
|
+
failEvery(kind, code = "JOURNAL_WRITE_FAILED") {
|
|
18
|
+
this.failingKind = kind;
|
|
19
|
+
if (kind !== null)
|
|
20
|
+
this.failure = code;
|
|
21
|
+
}
|
|
22
|
+
/** Forgets every record, as a fresh process would; the failures stay as set. */
|
|
23
|
+
clear() {
|
|
24
|
+
this.records.length = 0;
|
|
25
|
+
}
|
|
26
|
+
get all() {
|
|
27
|
+
return this.records;
|
|
28
|
+
}
|
|
29
|
+
async append(record) {
|
|
30
|
+
if (this.failingKind === record.record)
|
|
31
|
+
throw new Error(this.failure ?? "JOURNAL_WRITE_FAILED");
|
|
32
|
+
const failure = this.failingKind === null ? this.failure : null;
|
|
33
|
+
if (this.failingKind === null)
|
|
34
|
+
this.failure = null;
|
|
35
|
+
if (failure !== null)
|
|
36
|
+
throw new Error(failure);
|
|
37
|
+
this.records.push(record);
|
|
38
|
+
await Promise.resolve();
|
|
39
|
+
}
|
|
40
|
+
async openAttempts() {
|
|
41
|
+
return await Promise.resolve(openAttemptsFrom(this.records));
|
|
42
|
+
}
|
|
43
|
+
close() {
|
|
44
|
+
this.records.length = 0;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=InMemoryExecutionJournal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"InMemoryExecutionJournal.js","sourceRoot":"","sources":["../../src/journal/InMemoryExecutionJournal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAIjB,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IAClB,OAAO,GAAoB,EAAE,CAAC;IACvC,OAAO,GAAkB,IAAI,CAAC;IAC9B,WAAW,GAA6B,IAAI,CAAC;IAErD,mFAAmF;IAC5E,cAAc,CAAC,IAAI,GAAG,sBAAsB;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,qEAAqE;IAC9D,SAAS,CAAC,IAA8B,EAAE,IAAI,GAAG,sBAAsB;QAC5E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACzC,CAAC;IAED,gFAAgF;IACzE,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,MAAqB;QACvC,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;QAChG,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACnD,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { type ActionRegistry } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import type { SecurityEvents } from "../incident/SecurityEvents.js";
|
|
3
|
+
import type { ExecutionJournal, OpenAttempt } from "./ExecutionJournal.js";
|
|
4
|
+
export type AttemptResolution = "RECONCILED_COMPLETED" | "RECONCILED_NOT_EXECUTED" | "STILL_UNKNOWN" | "UNCLAIMED" | "BINDING_MISMATCH";
|
|
5
|
+
export interface ResolvedAttempt {
|
|
6
|
+
readonly intentId: string;
|
|
7
|
+
readonly intentHash: string;
|
|
8
|
+
readonly idempotencyKey: string;
|
|
9
|
+
readonly openedAt: string;
|
|
10
|
+
readonly state: OpenAttempt["state"];
|
|
11
|
+
readonly resolution: AttemptResolution;
|
|
12
|
+
}
|
|
13
|
+
export interface RecoveryReport {
|
|
14
|
+
readonly attempts: readonly ResolvedAttempt[];
|
|
15
|
+
/** Attempts whose outcome is still not known; `/ready` can be made to wait on these. */
|
|
16
|
+
readonly unknown: number;
|
|
17
|
+
}
|
|
18
|
+
export interface StartupReconcilerOptions {
|
|
19
|
+
readonly journal: ExecutionJournal;
|
|
20
|
+
readonly registry: ActionRegistry;
|
|
21
|
+
readonly events: SecurityEvents;
|
|
22
|
+
readonly clock?: () => Date;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* What the last process left behind, resolved before this one accepts a
|
|
26
|
+
* request. Every attempt the journal has open is read back, its stored
|
|
27
|
+
* intent re-hashed rather than trusted, and the provider asked what it did
|
|
28
|
+
* with that idempotency key, read-only. Nothing is ever re-executed here:
|
|
29
|
+
* the reconciler calls the registry's read path, never the execute path.
|
|
30
|
+
*
|
|
31
|
+
* An attempt that was opened but never claimed had no grant consumed, so
|
|
32
|
+
* the provider was never reached; the authority's own lease recovery owns
|
|
33
|
+
* it and this process says so rather than guessing. An attempt whose stored
|
|
34
|
+
* intent no longer hashes to its recorded hash is a tampered journal and is
|
|
35
|
+
* reported as such.
|
|
36
|
+
*/
|
|
37
|
+
export declare class StartupReconciler {
|
|
38
|
+
private readonly options;
|
|
39
|
+
private readonly hasher;
|
|
40
|
+
private readonly clock;
|
|
41
|
+
constructor(options: StartupReconcilerOptions);
|
|
42
|
+
recover(): Promise<RecoveryReport>;
|
|
43
|
+
private resolve;
|
|
44
|
+
/** Records how the attempt ended, so the next start does not ask again. */
|
|
45
|
+
private close;
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=StartupReconciler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"StartupReconciler.d.ts","sourceRoot":"","sources":["../../src/journal/StartupReconciler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GACzB,sBAAsB,GACtB,yBAAyB,GACzB,eAAe,GACf,WAAW,GACX,kBAAkB,CAAC;AAEvB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAIT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEC,OAAO,EAAE,wBAAwB;IAIxD,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;YA8BjC,OAAO;IAwBrB,2EAA2E;YAC7D,KAAK;CAapB"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { CanonicalIntentHasher, ExecutionIntentSchema, } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
/**
|
|
3
|
+
* What the last process left behind, resolved before this one accepts a
|
|
4
|
+
* request. Every attempt the journal has open is read back, its stored
|
|
5
|
+
* intent re-hashed rather than trusted, and the provider asked what it did
|
|
6
|
+
* with that idempotency key, read-only. Nothing is ever re-executed here:
|
|
7
|
+
* the reconciler calls the registry's read path, never the execute path.
|
|
8
|
+
*
|
|
9
|
+
* An attempt that was opened but never claimed had no grant consumed, so
|
|
10
|
+
* the provider was never reached; the authority's own lease recovery owns
|
|
11
|
+
* it and this process says so rather than guessing. An attempt whose stored
|
|
12
|
+
* intent no longer hashes to its recorded hash is a tampered journal and is
|
|
13
|
+
* reported as such.
|
|
14
|
+
*/
|
|
15
|
+
export class StartupReconciler {
|
|
16
|
+
options;
|
|
17
|
+
hasher = new CanonicalIntentHasher();
|
|
18
|
+
clock;
|
|
19
|
+
constructor(options) {
|
|
20
|
+
this.options = options;
|
|
21
|
+
this.clock = options.clock ?? (() => new Date());
|
|
22
|
+
}
|
|
23
|
+
async recover() {
|
|
24
|
+
const open = await this.options.journal.openAttempts();
|
|
25
|
+
const attempts = [];
|
|
26
|
+
for (const attempt of open) {
|
|
27
|
+
this.options.events.emit({
|
|
28
|
+
event: "OPEN_ATTEMPT_FOUND_AT_STARTUP",
|
|
29
|
+
intent_id: attempt.intentId,
|
|
30
|
+
state: attempt.state,
|
|
31
|
+
});
|
|
32
|
+
const resolution = await this.resolve(attempt);
|
|
33
|
+
attempts.push({
|
|
34
|
+
intentId: attempt.intentId,
|
|
35
|
+
intentHash: attempt.intentHash,
|
|
36
|
+
idempotencyKey: attempt.idempotencyKey,
|
|
37
|
+
openedAt: attempt.openedAt,
|
|
38
|
+
state: attempt.state,
|
|
39
|
+
resolution,
|
|
40
|
+
});
|
|
41
|
+
this.options.events.emit({
|
|
42
|
+
event: "OPEN_ATTEMPT_RESOLVED",
|
|
43
|
+
intent_id: attempt.intentId,
|
|
44
|
+
resolution,
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
return {
|
|
48
|
+
attempts,
|
|
49
|
+
unknown: attempts.filter((attempt) => attempt.resolution === "STILL_UNKNOWN").length,
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
async resolve(attempt) {
|
|
53
|
+
if (attempt.state === "OPENED") {
|
|
54
|
+
await this.close(attempt, "BLOCKED");
|
|
55
|
+
return "UNCLAIMED";
|
|
56
|
+
}
|
|
57
|
+
let captured;
|
|
58
|
+
try {
|
|
59
|
+
captured = this.hasher.capture(ExecutionIntentSchema.parse(attempt.intent));
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
return "BINDING_MISMATCH";
|
|
63
|
+
}
|
|
64
|
+
if (captured.intentHash !== attempt.intentHash)
|
|
65
|
+
return "BINDING_MISMATCH";
|
|
66
|
+
const reconciliation = await this.options.registry.reconcile(captured, attempt.idempotencyKey);
|
|
67
|
+
if (reconciliation.status === "COMPLETED") {
|
|
68
|
+
await this.close(attempt, "COMPLETED");
|
|
69
|
+
return "RECONCILED_COMPLETED";
|
|
70
|
+
}
|
|
71
|
+
if (reconciliation.status === "NOT_EXECUTED") {
|
|
72
|
+
await this.close(attempt, "DEFINITELY_NOT_EXECUTED");
|
|
73
|
+
return "RECONCILED_NOT_EXECUTED";
|
|
74
|
+
}
|
|
75
|
+
return "STILL_UNKNOWN";
|
|
76
|
+
}
|
|
77
|
+
/** Records how the attempt ended, so the next start does not ask again. */
|
|
78
|
+
async close(attempt, status) {
|
|
79
|
+
await this.options.journal.append({
|
|
80
|
+
record: "RECONCILED",
|
|
81
|
+
at: this.clock().toISOString(),
|
|
82
|
+
intent_id: attempt.intentId,
|
|
83
|
+
intent_hash: attempt.intentHash,
|
|
84
|
+
status,
|
|
85
|
+
source: "STARTUP",
|
|
86
|
+
});
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=StartupReconciler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"StartupReconciler.js","sourceRoot":"","sources":["../../src/journal/StartupReconciler.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import type { JsonObject } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
export type HardLimitCode = "HARD_LIMIT_EXCEEDED" | "HARD_LIMIT_CURRENCY_UNKNOWN" | "HARD_LIMIT_AMOUNT_INVALID" | "HARD_LIMIT_WINDOW_COUNT_EXCEEDED" | "HARD_LIMIT_WINDOW_SUM_EXCEEDED";
|
|
3
|
+
export interface HardLimitSettings {
|
|
4
|
+
/** The most one action may move, per ISO 4217 code, in minor units. */
|
|
5
|
+
readonly singleMinor: ReadonlyMap<string, bigint>;
|
|
6
|
+
readonly windowSeconds: number;
|
|
7
|
+
readonly windowCount: number | null;
|
|
8
|
+
readonly windowSumMinor: bigint | null;
|
|
9
|
+
}
|
|
10
|
+
/** What the limits read off an action: an amount in minor units and its currency. */
|
|
11
|
+
export interface MonetaryValue {
|
|
12
|
+
readonly currency: string;
|
|
13
|
+
readonly amountMinor: bigint;
|
|
14
|
+
}
|
|
15
|
+
export type LimitCheck = {
|
|
16
|
+
readonly allowed: true;
|
|
17
|
+
} | {
|
|
18
|
+
readonly allowed: false;
|
|
19
|
+
readonly code: HardLimitCode;
|
|
20
|
+
};
|
|
21
|
+
export declare class HardLimits {
|
|
22
|
+
readonly settings: HardLimitSettings;
|
|
23
|
+
private readonly clock;
|
|
24
|
+
/**
|
|
25
|
+
* One window, in the order the actions happened: when each was committed,
|
|
26
|
+
* and what it moved when it moved anything. The count and the sum are both
|
|
27
|
+
* derived from it, so there is no second list to keep in step.
|
|
28
|
+
*/
|
|
29
|
+
private readonly window;
|
|
30
|
+
constructor(settings: HardLimitSettings, clock: () => number);
|
|
31
|
+
/** `CHF:2500000000,EUR:1000000`: the ceiling per currency, in minor units. */
|
|
32
|
+
static parseCeilings(text: string, key: string): ReadonlyMap<string, bigint>;
|
|
33
|
+
/**
|
|
34
|
+
* The monetary value an action carries, when it carries one: an integer
|
|
35
|
+
* `amountMinor` and a three-letter `currency` among the intent's
|
|
36
|
+
* parameters. An action with neither is not a payment and is bounded by
|
|
37
|
+
* the count window alone; an action with one and not the other is refused,
|
|
38
|
+
* because a half-stated amount is not something to guess at.
|
|
39
|
+
*/
|
|
40
|
+
static monetaryValue(parameters: JsonObject): MonetaryValue | null | "INVALID";
|
|
41
|
+
/** Whether this action is inside every ceiling right now; it takes nothing. */
|
|
42
|
+
check(parameters: JsonObject): LimitCheck;
|
|
43
|
+
/**
|
|
44
|
+
* The decision and the value it was made about, together, so `commit` does
|
|
45
|
+
* not read the parameters a second time and an invalid amount never
|
|
46
|
+
* escapes this method: it is a refusal here, and what leaves is either a
|
|
47
|
+
* value or nothing.
|
|
48
|
+
*/
|
|
49
|
+
private evaluate;
|
|
50
|
+
private within;
|
|
51
|
+
/** Takes this action's place in the windows, after the check and before it runs. */
|
|
52
|
+
commit(parameters: JsonObject): LimitCheck;
|
|
53
|
+
/**
|
|
54
|
+
* The window, pruned. Entries are pushed in the order the clock gave them,
|
|
55
|
+
* so the old ones are at the front and dropping them is a walk from there
|
|
56
|
+
* rather than a pass over the whole list. A clock that went backwards
|
|
57
|
+
* stops the walk early and keeps an entry a moment longer, which refuses
|
|
58
|
+
* more rather than less.
|
|
59
|
+
*/
|
|
60
|
+
private recent;
|
|
61
|
+
private recentSum;
|
|
62
|
+
}
|
|
63
|
+
//# sourceMappingURL=HardLimits.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HardLimits.d.ts","sourceRoot":"","sources":["../../src/limits/HardLimits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,6BAA6B,GAC7B,2BAA2B,GAC3B,kCAAkC,GAClC,gCAAgC,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GACpB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAuBzF,qBAAa,UAAU;aASH,QAAQ,EAAE,iBAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;IATxB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAG1B,QAAQ,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,MAAM;IAGtC,8EAA8E;WAChE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBnF;;;;;;OAMG;WACW,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS;IAarF,+EAA+E;IACxE,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU;IAIhD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,MAAM;IAiBd,oFAAoF;IAC7E,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU;IAOjD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,SAAS;CAGlB"}
|