@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,187 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { mkdirSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
export const EVIDENCE_BUNDLE_VERSION = "agent-safe.evidence-bundle/1";
|
|
5
|
+
const MAX_WINDOW_LINES = 200_000;
|
|
6
|
+
export class EvidenceError extends Error {
|
|
7
|
+
code;
|
|
8
|
+
constructor(code) {
|
|
9
|
+
super(code);
|
|
10
|
+
this.code = code;
|
|
11
|
+
this.name = "EvidenceError";
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* The last N lines of one stream, and how many fell off the end.
|
|
16
|
+
*
|
|
17
|
+
* The durable store for evidence is the log pipeline the lines are written
|
|
18
|
+
* to; this window exists so an operator can take a bundle out of a running
|
|
19
|
+
* process during an incident without first arranging log export. Saying how
|
|
20
|
+
* many lines were dropped is the point: a bundle that silently held a partial
|
|
21
|
+
* range would look like a complete one, and the chain's own sequence numbers
|
|
22
|
+
* are what let a reader see the gap.
|
|
23
|
+
*/
|
|
24
|
+
export class LineWindow {
|
|
25
|
+
capacity;
|
|
26
|
+
buffer = [];
|
|
27
|
+
droppedCount = 0;
|
|
28
|
+
constructor(capacity) {
|
|
29
|
+
this.capacity = capacity;
|
|
30
|
+
if (!Number.isInteger(capacity) || capacity < 1 || capacity > MAX_WINDOW_LINES) {
|
|
31
|
+
throw new RangeError("EVIDENCE_WINDOW_INVALID");
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
push(line) {
|
|
35
|
+
this.buffer.push(line);
|
|
36
|
+
while (this.buffer.length > this.capacity) {
|
|
37
|
+
this.buffer.shift();
|
|
38
|
+
this.droppedCount += 1;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
/** Wraps a writer so every line it takes is also remembered here. */
|
|
42
|
+
tee(write) {
|
|
43
|
+
return (line) => {
|
|
44
|
+
this.push(line);
|
|
45
|
+
write(line);
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
get lines() {
|
|
49
|
+
return this.buffer;
|
|
50
|
+
}
|
|
51
|
+
get dropped() {
|
|
52
|
+
return this.droppedCount;
|
|
53
|
+
}
|
|
54
|
+
clear() {
|
|
55
|
+
this.buffer.length = 0;
|
|
56
|
+
this.droppedCount = 0;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
const sha256 = (body) => `sha256:${createHash("sha256").update(body, "utf8").digest("hex")}`;
|
|
60
|
+
/**
|
|
61
|
+
* An evidence bundle: what this process can say about an incident, written
|
|
62
|
+
* where an operator can pick it up, with a manifest that digests every file
|
|
63
|
+
* so a later reader can tell the bundle they hold is the bundle that was
|
|
64
|
+
* made.
|
|
65
|
+
*
|
|
66
|
+
* What is deliberately not in it: any secret, any digest of a secret (a
|
|
67
|
+
* low-entropy credential's digest is a guessable oracle), any request
|
|
68
|
+
* parameter, and any provider body. The attempt journal holds parameters, so
|
|
69
|
+
* it is named by identifier and state and never copied. What is in it is
|
|
70
|
+
* identifiers, digests, statuses, counts and the two chained streams.
|
|
71
|
+
*
|
|
72
|
+
* Without a signing key the bundle proves its own internal consistency and
|
|
73
|
+
* nothing about who produced it. With one it carries a detached JWS over the
|
|
74
|
+
* manifest, and `verify-bundle` says which of the two a reader is holding
|
|
75
|
+
* rather than letting the distinction pass unnoticed.
|
|
76
|
+
*/
|
|
77
|
+
export class EvidenceExport {
|
|
78
|
+
options;
|
|
79
|
+
clock;
|
|
80
|
+
write;
|
|
81
|
+
makeDir;
|
|
82
|
+
constructor(options) {
|
|
83
|
+
this.options = options;
|
|
84
|
+
this.clock = options.clock ?? (() => new Date());
|
|
85
|
+
this.write =
|
|
86
|
+
options.writeFile ??
|
|
87
|
+
((path, body) => {
|
|
88
|
+
writeFileSync(path, body, { mode: 0o600 });
|
|
89
|
+
});
|
|
90
|
+
this.makeDir =
|
|
91
|
+
options.makeDir ??
|
|
92
|
+
((path) => {
|
|
93
|
+
mkdirSync(path, { recursive: true, mode: 0o700 });
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
get configured() {
|
|
97
|
+
return this.options.dir !== null;
|
|
98
|
+
}
|
|
99
|
+
async export(input) {
|
|
100
|
+
const root = this.options.dir;
|
|
101
|
+
if (root === null)
|
|
102
|
+
throw new EvidenceError("EVIDENCE_DIR_NOT_CONFIGURED");
|
|
103
|
+
const at = this.clock();
|
|
104
|
+
// One directory per export, named by the instant, so two exports during
|
|
105
|
+
// one incident do not overwrite each other.
|
|
106
|
+
const directory = join(root, at.toISOString().replace(/[:.]/g, "-"));
|
|
107
|
+
const posture = this.options.posture();
|
|
108
|
+
const contents = [
|
|
109
|
+
{
|
|
110
|
+
name: "audit.jsonl",
|
|
111
|
+
body: `${this.options.audit.lines.join("\n")}\n`,
|
|
112
|
+
dropped: this.options.audit.dropped,
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
name: "security-events.jsonl",
|
|
116
|
+
body: `${this.options.security.lines.join("\n")}\n`,
|
|
117
|
+
dropped: this.options.security.dropped,
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
name: "open-attempts.json",
|
|
121
|
+
body: `${JSON.stringify(this.options.openAttempts(), null, 2)}\n`,
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
name: "posture.json",
|
|
125
|
+
body: `${JSON.stringify({
|
|
126
|
+
mode: posture.mode,
|
|
127
|
+
// Checks by name and outcome; a finding's own detail can name a
|
|
128
|
+
// path, so only the check identifier travels.
|
|
129
|
+
failed: posture.failed.map((finding) => finding.id),
|
|
130
|
+
waived: posture.waived.map((finding) => finding.id),
|
|
131
|
+
checks: posture.findings.length,
|
|
132
|
+
}, null, 2)}\n`,
|
|
133
|
+
},
|
|
134
|
+
];
|
|
135
|
+
try {
|
|
136
|
+
this.makeDir(directory);
|
|
137
|
+
for (const file of contents)
|
|
138
|
+
this.write(join(directory, file.name), file.body);
|
|
139
|
+
}
|
|
140
|
+
catch {
|
|
141
|
+
throw new EvidenceError("EVIDENCE_WRITE_FAILED");
|
|
142
|
+
}
|
|
143
|
+
const manifest = {
|
|
144
|
+
version: EVIDENCE_BUNDLE_VERSION,
|
|
145
|
+
exported_at: at.toISOString(),
|
|
146
|
+
exported_by: input.principal,
|
|
147
|
+
reason: input.reason.slice(0, 200),
|
|
148
|
+
package_version: this.options.packageVersion,
|
|
149
|
+
// Reported by the platform, not read from the running image: a process
|
|
150
|
+
// cannot verify what it was built from, and saying otherwise would be
|
|
151
|
+
// the most misleading line in the bundle.
|
|
152
|
+
image: { digest: this.options.imageDigest, self_verified: false },
|
|
153
|
+
configuration_digest: sha256(JSON.stringify(this.options.configuration())),
|
|
154
|
+
secrets: this.options.secrets().map((secret) => ({ ...secret })),
|
|
155
|
+
chains: Object.fromEntries(Object.entries(this.options.heads()).map(([stream, head]) => [
|
|
156
|
+
stream,
|
|
157
|
+
{ seq: head.seq, hash: head.hash },
|
|
158
|
+
])),
|
|
159
|
+
files: contents.map((file) => ({
|
|
160
|
+
name: file.name,
|
|
161
|
+
bytes: Buffer.byteLength(file.body, "utf8"),
|
|
162
|
+
sha256: sha256(file.body),
|
|
163
|
+
...(file.dropped === undefined ? {} : { dropped: file.dropped }),
|
|
164
|
+
})),
|
|
165
|
+
};
|
|
166
|
+
const body = `${JSON.stringify(manifest, null, 2)}\n`;
|
|
167
|
+
let signature = null;
|
|
168
|
+
if (this.options.sign !== undefined) {
|
|
169
|
+
try {
|
|
170
|
+
signature = await this.options.sign(Buffer.from(body, "utf8"));
|
|
171
|
+
}
|
|
172
|
+
catch {
|
|
173
|
+
throw new EvidenceError("EVIDENCE_SIGNING_FAILED");
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
try {
|
|
177
|
+
this.write(join(directory, "manifest.json"), body);
|
|
178
|
+
if (signature !== null)
|
|
179
|
+
this.write(join(directory, "manifest.jws"), `${signature}\n`);
|
|
180
|
+
}
|
|
181
|
+
catch {
|
|
182
|
+
throw new EvidenceError("EVIDENCE_WRITE_FAILED");
|
|
183
|
+
}
|
|
184
|
+
return { directory, manifest, signature };
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
//# sourceMappingURL=EvidenceExport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EvidenceExport.js","sourceRoot":"","sources":["../../src/incident/EvidenceExport.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { type FSWatcher } from "node:fs";
|
|
2
|
+
/**
|
|
3
|
+
* Whether a path is a regular file this process can see.
|
|
4
|
+
*
|
|
5
|
+
* This is the one thing the halt switch asks of the host, kept in its own
|
|
6
|
+
* module because it is a question about the filesystem rather than about the
|
|
7
|
+
* stop: anything the process cannot stat is not a halt file — no such path,
|
|
8
|
+
* an unreadable parent directory, a symlink loop — and the look must answer
|
|
9
|
+
* rather than throw, because it also runs inside the poll's own callback.
|
|
10
|
+
*/
|
|
11
|
+
export declare function regularFileExists(path: string): boolean;
|
|
12
|
+
/**
|
|
13
|
+
* Follows a directory for changes, without holding the process open.
|
|
14
|
+
*
|
|
15
|
+
* The halt file's own directory is what is watched rather than the file: a
|
|
16
|
+
* secret or ConfigMap mount replaces the file by swapping a symlink, and a
|
|
17
|
+
* watch on the old inode would never fire again. `persistent: false` keeps
|
|
18
|
+
* the watch from being a reason for the process to stay alive, which matters
|
|
19
|
+
* because the stop is followed for the whole life of the executor.
|
|
20
|
+
*/
|
|
21
|
+
export declare function watchDirectory(path: string, onChange: () => void): FSWatcher;
|
|
22
|
+
//# sourceMappingURL=FileProbe.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FileProbe.d.ts","sourceRoot":"","sources":["../../src/incident/FileProbe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,SAAS,CAE5E"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { statSync, watch } from "node:fs";
|
|
2
|
+
/**
|
|
3
|
+
* Whether a path is a regular file this process can see.
|
|
4
|
+
*
|
|
5
|
+
* This is the one thing the halt switch asks of the host, kept in its own
|
|
6
|
+
* module because it is a question about the filesystem rather than about the
|
|
7
|
+
* stop: anything the process cannot stat is not a halt file — no such path,
|
|
8
|
+
* an unreadable parent directory, a symlink loop — and the look must answer
|
|
9
|
+
* rather than throw, because it also runs inside the poll's own callback.
|
|
10
|
+
*/
|
|
11
|
+
export function regularFileExists(path) {
|
|
12
|
+
try {
|
|
13
|
+
return statSync(path).isFile();
|
|
14
|
+
}
|
|
15
|
+
catch {
|
|
16
|
+
return false;
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Follows a directory for changes, without holding the process open.
|
|
21
|
+
*
|
|
22
|
+
* The halt file's own directory is what is watched rather than the file: a
|
|
23
|
+
* secret or ConfigMap mount replaces the file by swapping a symlink, and a
|
|
24
|
+
* watch on the old inode would never fire again. `persistent: false` keeps
|
|
25
|
+
* the watch from being a reason for the process to stay alive, which matters
|
|
26
|
+
* because the stop is followed for the whole life of the executor.
|
|
27
|
+
*/
|
|
28
|
+
export function watchDirectory(path, onChange) {
|
|
29
|
+
return watch(path, { persistent: false }, onChange);
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=FileProbe.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FileProbe.js","sourceRoot":"","sources":["../../src/incident/FileProbe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAkB,MAAM,SAAS,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAoB;IAC/D,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { FSWatcher } from "node:fs";
|
|
2
|
+
import { type RateLimitRule } from "../identity/RateLimiter.js";
|
|
3
|
+
import type { SecurityEvents } from "./SecurityEvents.js";
|
|
4
|
+
/** Why the executor stopped taking new work. */
|
|
5
|
+
export type HaltTrigger = "OPERATOR" | "HALT_FILE" | "POSTURE_DRIFT" | "AUTH_FAILURE_SPIKE" | "EGRESS_REFUSAL_SPIKE" | "CLOCK_SKEW" | "AUDIT_CHAIN_BROKEN" | "EFFECT_MISMATCH";
|
|
6
|
+
export interface HaltState {
|
|
7
|
+
readonly halted: boolean;
|
|
8
|
+
readonly trigger: HaltTrigger | null;
|
|
9
|
+
/** An operator's words, or the trigger's own code; never anything from a request. */
|
|
10
|
+
readonly reason: string | null;
|
|
11
|
+
readonly since: string | null;
|
|
12
|
+
}
|
|
13
|
+
export interface HaltSwitchOptions {
|
|
14
|
+
readonly events: SecurityEvents;
|
|
15
|
+
/** A file whose presence halts the executor, watched and polled; none when null. */
|
|
16
|
+
readonly haltFile?: string | null;
|
|
17
|
+
/** `<count>/<seconds>`: how many door refusals in a window halt the executor. */
|
|
18
|
+
readonly authFailures?: RateLimitRule | null;
|
|
19
|
+
readonly egressRefusals?: RateLimitRule | null;
|
|
20
|
+
readonly posture?: {
|
|
21
|
+
readonly degraded: boolean;
|
|
22
|
+
};
|
|
23
|
+
readonly clock?: () => Date;
|
|
24
|
+
readonly fileExists?: (path: string) => boolean;
|
|
25
|
+
readonly pollSeconds?: number;
|
|
26
|
+
/**
|
|
27
|
+
* How the halt file's directory is followed. The default is `fs.watch`; a
|
|
28
|
+
* test supplies its own so the error path, and the failure to watch at
|
|
29
|
+
* all, are reachable without a filesystem that misbehaves on demand.
|
|
30
|
+
*/
|
|
31
|
+
readonly watchDirectory?: (path: string, onChange: () => void) => FSWatcher;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* The stop. It is deliberately easy to reach and deliberately hard to
|
|
35
|
+
* leave: an operator halts with a reason, a file halts by existing, and a
|
|
36
|
+
* spike of refusals at the door, a refused outbound request, a posture
|
|
37
|
+
* drift, a clock that cannot be trusted or a broken evidence chain halt on
|
|
38
|
+
* their own. While halted, the executor takes no new work; what is already
|
|
39
|
+
* in flight finishes and is journaled, because abandoning a dispatch is how
|
|
40
|
+
* an outcome becomes unknown.
|
|
41
|
+
*
|
|
42
|
+
* Resuming is an operator's act with a reason, and it is refused while the
|
|
43
|
+
* cause still stands: the halt file still there, a posture drift still
|
|
44
|
+
* standing. A process that starts with the halt file present starts halted.
|
|
45
|
+
*
|
|
46
|
+
* A spike threshold is reachable from the agent zone by design: a
|
|
47
|
+
* compromised caller that floods the door with bad credentials stops the
|
|
48
|
+
* executor rather than being ignored. That is the fail-closed choice, and
|
|
49
|
+
* the threshold is configurable for institutions that would rather not.
|
|
50
|
+
*/
|
|
51
|
+
export declare class HaltSwitch {
|
|
52
|
+
private readonly options;
|
|
53
|
+
private state;
|
|
54
|
+
private readonly limits;
|
|
55
|
+
private readonly clock;
|
|
56
|
+
private readonly exists;
|
|
57
|
+
private readonly haltFile;
|
|
58
|
+
private readonly authFailures;
|
|
59
|
+
private readonly egressRefusals;
|
|
60
|
+
private readonly pollMs;
|
|
61
|
+
private readonly watchDirectory;
|
|
62
|
+
/** The one thing `start()` leaves behind, so stopping is one call. */
|
|
63
|
+
private readonly stopper;
|
|
64
|
+
private watcher;
|
|
65
|
+
private cancelPoll;
|
|
66
|
+
constructor(options: HaltSwitchOptions);
|
|
67
|
+
get current(): HaltState;
|
|
68
|
+
get halted(): boolean;
|
|
69
|
+
/** Whether this switch is following a halt file right now. */
|
|
70
|
+
get following(): boolean;
|
|
71
|
+
/** The halt file decides the starting state, so a restart does not undo a halt. */
|
|
72
|
+
assertAtStartup(): HaltState;
|
|
73
|
+
/** Follows the halt file while running: created halts, removed only allows a resume. */
|
|
74
|
+
start(): () => void;
|
|
75
|
+
stop(): void;
|
|
76
|
+
/** One look at the halt file; for the interval, the watcher, and tests. */
|
|
77
|
+
check(): void;
|
|
78
|
+
halt(trigger: HaltTrigger, reason: string): HaltState;
|
|
79
|
+
/**
|
|
80
|
+
* Lets work through again, on an operator's word and with a reason. It is
|
|
81
|
+
* refused while the cause stands: the code says which cause, so the
|
|
82
|
+
* operator fixes that rather than retrying.
|
|
83
|
+
*/
|
|
84
|
+
resume(reason: string): {
|
|
85
|
+
readonly resumed: boolean;
|
|
86
|
+
readonly code: string | null;
|
|
87
|
+
};
|
|
88
|
+
/** One refusal at the door; the window's threshold halts the executor. */
|
|
89
|
+
recordAuthFailure(): void;
|
|
90
|
+
/** One outbound request the egress policy refused; the window's threshold halts. */
|
|
91
|
+
recordEgressRefusal(): void;
|
|
92
|
+
private recordSpike;
|
|
93
|
+
private haltFilePresent;
|
|
94
|
+
}
|
|
95
|
+
//# sourceMappingURL=HaltSwitch.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HaltSwitch.d.ts","sourceRoot":"","sources":["../../src/incident/HaltSwitch.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
import { dirname } from "node:path";
|
|
2
|
+
import { regularFileExists, watchDirectory } from "./FileProbe.js";
|
|
3
|
+
import { RateLimiter } from "../identity/RateLimiter.js";
|
|
4
|
+
const POLL_SECONDS = 5;
|
|
5
|
+
/**
|
|
6
|
+
* The stop. It is deliberately easy to reach and deliberately hard to
|
|
7
|
+
* leave: an operator halts with a reason, a file halts by existing, and a
|
|
8
|
+
* spike of refusals at the door, a refused outbound request, a posture
|
|
9
|
+
* drift, a clock that cannot be trusted or a broken evidence chain halt on
|
|
10
|
+
* their own. While halted, the executor takes no new work; what is already
|
|
11
|
+
* in flight finishes and is journaled, because abandoning a dispatch is how
|
|
12
|
+
* an outcome becomes unknown.
|
|
13
|
+
*
|
|
14
|
+
* Resuming is an operator's act with a reason, and it is refused while the
|
|
15
|
+
* cause still stands: the halt file still there, a posture drift still
|
|
16
|
+
* standing. A process that starts with the halt file present starts halted.
|
|
17
|
+
*
|
|
18
|
+
* A spike threshold is reachable from the agent zone by design: a
|
|
19
|
+
* compromised caller that floods the door with bad credentials stops the
|
|
20
|
+
* executor rather than being ignored. That is the fail-closed choice, and
|
|
21
|
+
* the threshold is configurable for institutions that would rather not.
|
|
22
|
+
*/
|
|
23
|
+
export class HaltSwitch {
|
|
24
|
+
options;
|
|
25
|
+
state;
|
|
26
|
+
limits;
|
|
27
|
+
clock;
|
|
28
|
+
exists;
|
|
29
|
+
// Every optional setting is resolved once, here, so that no check further
|
|
30
|
+
// down has a half no input could reach: `undefined` and `null` both mean
|
|
31
|
+
// "not configured", and saying that twice per use is a branch with no
|
|
32
|
+
// behaviour behind it.
|
|
33
|
+
haltFile;
|
|
34
|
+
authFailures;
|
|
35
|
+
egressRefusals;
|
|
36
|
+
pollMs;
|
|
37
|
+
watchDirectory;
|
|
38
|
+
/** The one thing `start()` leaves behind, so stopping is one call. */
|
|
39
|
+
stopper = () => this.stop();
|
|
40
|
+
watcher = null;
|
|
41
|
+
cancelPoll = null;
|
|
42
|
+
constructor(options) {
|
|
43
|
+
this.options = options;
|
|
44
|
+
this.clock = options.clock ?? (() => new Date());
|
|
45
|
+
this.exists = options.fileExists ?? regularFileExists;
|
|
46
|
+
this.haltFile = options.haltFile ?? null;
|
|
47
|
+
this.authFailures = options.authFailures ?? null;
|
|
48
|
+
this.egressRefusals = options.egressRefusals ?? null;
|
|
49
|
+
this.pollMs = (options.pollSeconds ?? POLL_SECONDS) * 1_000;
|
|
50
|
+
this.watchDirectory = options.watchDirectory ?? watchDirectory;
|
|
51
|
+
this.limits = new RateLimiter(() => this.clock().getTime());
|
|
52
|
+
this.state = { halted: false, trigger: null, reason: null, since: null };
|
|
53
|
+
}
|
|
54
|
+
get current() {
|
|
55
|
+
return this.state;
|
|
56
|
+
}
|
|
57
|
+
get halted() {
|
|
58
|
+
return this.state.halted;
|
|
59
|
+
}
|
|
60
|
+
/** Whether this switch is following a halt file right now. */
|
|
61
|
+
get following() {
|
|
62
|
+
return this.cancelPoll !== null;
|
|
63
|
+
}
|
|
64
|
+
/** The halt file decides the starting state, so a restart does not undo a halt. */
|
|
65
|
+
assertAtStartup() {
|
|
66
|
+
if (this.haltFilePresent())
|
|
67
|
+
this.halt("HALT_FILE", "the halt file was present at start");
|
|
68
|
+
return this.state;
|
|
69
|
+
}
|
|
70
|
+
/** Follows the halt file while running: created halts, removed only allows a resume. */
|
|
71
|
+
start() {
|
|
72
|
+
this.stop();
|
|
73
|
+
const file = this.haltFile;
|
|
74
|
+
if (file === null)
|
|
75
|
+
return this.stopper;
|
|
76
|
+
// The watcher is the fast path and the poll is the one that has to work:
|
|
77
|
+
// a mount that reports no events, or a platform that refuses to watch at
|
|
78
|
+
// all, still halts within the interval. So a failed watch is not an
|
|
79
|
+
// error, and an unwatchable directory leaves the poll doing the job.
|
|
80
|
+
try {
|
|
81
|
+
const watcher = this.watchDirectory(dirname(file), () => this.check());
|
|
82
|
+
watcher.on("error", () => undefined);
|
|
83
|
+
this.watcher = watcher;
|
|
84
|
+
}
|
|
85
|
+
catch {
|
|
86
|
+
// `start()` cleared the watcher before this, so there is nothing to
|
|
87
|
+
// undo: the poll below is what keeps the stop reachable.
|
|
88
|
+
}
|
|
89
|
+
const poll = setInterval(() => this.check(), this.pollMs);
|
|
90
|
+
// Unreferenced, so following the halt file never holds the process open.
|
|
91
|
+
// Stryker disable next-line all: process lifetime is not observable from inside this process.
|
|
92
|
+
poll.unref();
|
|
93
|
+
this.cancelPoll = () => clearInterval(poll);
|
|
94
|
+
return this.stopper;
|
|
95
|
+
}
|
|
96
|
+
stop() {
|
|
97
|
+
this.watcher?.close();
|
|
98
|
+
this.watcher = null;
|
|
99
|
+
this.cancelPoll?.();
|
|
100
|
+
this.cancelPoll = null;
|
|
101
|
+
}
|
|
102
|
+
/** One look at the halt file; for the interval, the watcher, and tests. */
|
|
103
|
+
check() {
|
|
104
|
+
if (this.haltFilePresent() && !this.state.halted) {
|
|
105
|
+
this.halt("HALT_FILE", "the halt file appeared");
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
halt(trigger, reason) {
|
|
109
|
+
if (this.state.halted)
|
|
110
|
+
return this.state;
|
|
111
|
+
this.state = {
|
|
112
|
+
halted: true,
|
|
113
|
+
trigger,
|
|
114
|
+
reason: reason.slice(0, 200),
|
|
115
|
+
since: this.clock().toISOString(),
|
|
116
|
+
};
|
|
117
|
+
// Stryker disable next-line StringLiteral: the reason was set just above; the fallback satisfies the type.
|
|
118
|
+
this.options.events.emit({ event: "HALTED", trigger, reason: this.state.reason ?? "" });
|
|
119
|
+
return this.state;
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Lets work through again, on an operator's word and with a reason. It is
|
|
123
|
+
* refused while the cause stands: the code says which cause, so the
|
|
124
|
+
* operator fixes that rather than retrying.
|
|
125
|
+
*/
|
|
126
|
+
resume(reason) {
|
|
127
|
+
if (!this.state.halted)
|
|
128
|
+
return { resumed: false, code: "NOT_HALTED" };
|
|
129
|
+
if (this.haltFilePresent())
|
|
130
|
+
return { resumed: false, code: "HALT_CAUSE_PERSISTS" };
|
|
131
|
+
if (this.options.posture?.degraded === true) {
|
|
132
|
+
return { resumed: false, code: "HALT_CAUSE_PERSISTS" };
|
|
133
|
+
}
|
|
134
|
+
const from = this.state.trigger;
|
|
135
|
+
this.state = { halted: false, trigger: null, reason: null, since: null };
|
|
136
|
+
this.options.events.emit({
|
|
137
|
+
event: "RESUMED",
|
|
138
|
+
// Stryker disable next-line StringLiteral: a halted switch always has a trigger; the fallback satisfies the type.
|
|
139
|
+
trigger: from ?? "OPERATOR",
|
|
140
|
+
reason: reason.slice(0, 200),
|
|
141
|
+
});
|
|
142
|
+
return { resumed: true, code: null };
|
|
143
|
+
}
|
|
144
|
+
/** One refusal at the door; the window's threshold halts the executor. */
|
|
145
|
+
recordAuthFailure() {
|
|
146
|
+
this.recordSpike(this.authFailures, "AUTH_FAILURE_SPIKE");
|
|
147
|
+
}
|
|
148
|
+
/** One outbound request the egress policy refused; the window's threshold halts. */
|
|
149
|
+
recordEgressRefusal() {
|
|
150
|
+
this.recordSpike(this.egressRefusals, "EGRESS_REFUSAL_SPIKE");
|
|
151
|
+
}
|
|
152
|
+
recordSpike(rule, trigger) {
|
|
153
|
+
if (rule === null || this.state.halted)
|
|
154
|
+
return;
|
|
155
|
+
// The trigger is the bucket: each kind of refusal has its own window,
|
|
156
|
+
// and there is no second name to keep in step with it.
|
|
157
|
+
const key = trigger;
|
|
158
|
+
// The rule reads as it is written: `50/60` halts on the fiftieth refusal
|
|
159
|
+
// inside a minute, so this one is counted and then the window is asked
|
|
160
|
+
// whether it is now full.
|
|
161
|
+
this.limits.allow(key, rule);
|
|
162
|
+
if (this.limits.exhausted(key, rule)) {
|
|
163
|
+
this.halt(trigger, `${rule.count} in ${rule.windowSeconds}s`);
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
haltFilePresent() {
|
|
167
|
+
const file = this.haltFile;
|
|
168
|
+
return file === null ? false : this.exists(file);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=HaltSwitch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HaltSwitch.js","sourceRoot":"","sources":["../../src/incident/HaltSwitch.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import type { SecurityEvent } from "./SecurityEvents.js";
|
|
2
|
+
export type LabelValues = Readonly<Record<string, string>>;
|
|
3
|
+
interface Family {
|
|
4
|
+
readonly name: string;
|
|
5
|
+
readonly help: string;
|
|
6
|
+
readonly kind: "counter" | "gauge";
|
|
7
|
+
readonly labels: readonly string[];
|
|
8
|
+
readonly samples: Map<string, {
|
|
9
|
+
readonly values: readonly string[];
|
|
10
|
+
value: number;
|
|
11
|
+
}>;
|
|
12
|
+
}
|
|
13
|
+
/** One family's handle: label names fixed at creation, values bounded by what the code passes. */
|
|
14
|
+
export declare class Counter {
|
|
15
|
+
private readonly family;
|
|
16
|
+
constructor(family: Family);
|
|
17
|
+
inc(labels?: LabelValues, by?: number): void;
|
|
18
|
+
get(labels?: LabelValues): number;
|
|
19
|
+
}
|
|
20
|
+
export declare class Gauge {
|
|
21
|
+
private readonly family;
|
|
22
|
+
constructor(family: Family);
|
|
23
|
+
set(value: number, labels?: LabelValues): void;
|
|
24
|
+
get(labels?: LabelValues): number;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* A registry of counters and gauges with fixed label names, rendered as
|
|
28
|
+
* OpenMetrics text. Label values are codes, verdicts, names, and checks the
|
|
29
|
+
* code itself supplies, never anything a caller sent, so cardinality is
|
|
30
|
+
* bounded by the vocabulary and no value can leak through a label.
|
|
31
|
+
*/
|
|
32
|
+
export declare class Metrics {
|
|
33
|
+
private readonly families;
|
|
34
|
+
counter(name: string, help: string, labels?: readonly string[]): Counter;
|
|
35
|
+
gauge(name: string, help: string, labels?: readonly string[]): Gauge;
|
|
36
|
+
/** The exposition, families in registration order, samples in first-seen order, `# EOF` last. */
|
|
37
|
+
render(): string;
|
|
38
|
+
/** @internal */
|
|
39
|
+
static sample(family: Family, labels: LabelValues): {
|
|
40
|
+
readonly values: readonly string[];
|
|
41
|
+
value: number;
|
|
42
|
+
};
|
|
43
|
+
private family;
|
|
44
|
+
}
|
|
45
|
+
/** The executor's own families, and the observer that counts security events into them. */
|
|
46
|
+
export interface ExecutorMetrics {
|
|
47
|
+
readonly registry: Metrics;
|
|
48
|
+
readonly proposals: Counter;
|
|
49
|
+
readonly executions: Counter;
|
|
50
|
+
readonly authFailures: Counter;
|
|
51
|
+
readonly egressRefused: Counter;
|
|
52
|
+
readonly secretRotations: Counter;
|
|
53
|
+
readonly postureDrift: Counter;
|
|
54
|
+
readonly leaksSuspected: Counter;
|
|
55
|
+
readonly tlsRotations: Counter;
|
|
56
|
+
readonly auditLines: Counter;
|
|
57
|
+
readonly principalsLocked: Counter;
|
|
58
|
+
readonly operatorActions: Counter;
|
|
59
|
+
readonly halts: Counter;
|
|
60
|
+
readonly hardLimitRefusals: Counter;
|
|
61
|
+
readonly journalWriteFailures: Counter;
|
|
62
|
+
readonly effectComparisons: Counter;
|
|
63
|
+
readonly finalizations: Counter;
|
|
64
|
+
readonly evidenceExports: Counter;
|
|
65
|
+
readonly openAttempts: Gauge;
|
|
66
|
+
readonly clockSkew: Gauge;
|
|
67
|
+
observe(event: SecurityEvent): void;
|
|
68
|
+
}
|
|
69
|
+
export declare function executorMetrics(registry?: Metrics): ExecutorMetrics;
|
|
70
|
+
export {};
|
|
71
|
+
//# sourceMappingURL=Metrics.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Metrics.d.ts","sourceRoot":"","sources":["../../src/incident/Metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3D,UAAU,MAAM;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtF;AAMD,kGAAkG;AAClG,qBAAa,OAAO;IACC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,GAAG,CAAC,MAAM,GAAE,WAAgB,EAAE,EAAE,SAAI,GAAG,IAAI;IAI3C,GAAG,CAAC,MAAM,GAAE,WAAgB,GAAG,MAAM;CAG7C;AAED,qBAAa,KAAK;IACG,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,GAAG,IAAI;IAIlD,GAAG,CAAC,MAAM,GAAE,WAAgB,GAAG,MAAM;CAG7C;AAED;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAE/C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,MAAM,EAAO,GAAG,OAAO;IAI5E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,MAAM,EAAO,GAAG,KAAK;IAI/E,iGAAiG;IAC1F,MAAM,IAAI,MAAM;IAgBvB,gBAAgB;WACF,MAAM,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAWxD,OAAO,CAAC,MAAM;CAYf;AAED,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,wBAAgB,eAAe,CAAC,QAAQ,GAAE,OAAuB,GAAG,eAAe,CA6HlF"}
|