@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,102 @@
|
|
|
1
|
+
import { type OperatorScope, type PrincipalEntry } from "./PrincipalsFile.js";
|
|
2
|
+
import { type RateLimitRule } from "./RateLimiter.js";
|
|
3
|
+
export type Role = "PROPOSER" | "OPERATOR";
|
|
4
|
+
export type ClaimValue = string | number | boolean;
|
|
5
|
+
export interface PrincipalActor {
|
|
6
|
+
readonly id: string;
|
|
7
|
+
readonly type: string;
|
|
8
|
+
readonly runtime?: string;
|
|
9
|
+
}
|
|
10
|
+
export type PrincipalCredential = {
|
|
11
|
+
readonly kind: "BEARER";
|
|
12
|
+
readonly digest: () => Uint8Array;
|
|
13
|
+
} | {
|
|
14
|
+
readonly kind: "MTLS";
|
|
15
|
+
readonly sanUri: string;
|
|
16
|
+
readonly fingerprint: string | null;
|
|
17
|
+
} | {
|
|
18
|
+
readonly kind: "WORKLOAD_JWT";
|
|
19
|
+
readonly issuer: string;
|
|
20
|
+
readonly subject: string;
|
|
21
|
+
readonly audience: string | null;
|
|
22
|
+
readonly requiredClaims: Readonly<Record<string, ClaimValue>>;
|
|
23
|
+
};
|
|
24
|
+
export interface Principal {
|
|
25
|
+
readonly id: string;
|
|
26
|
+
readonly role: Role;
|
|
27
|
+
/** A proposer's tenant and actor: what its intents carry. Null for an operator. */
|
|
28
|
+
readonly tenantId: string | null;
|
|
29
|
+
readonly actor: PrincipalActor | null;
|
|
30
|
+
readonly allowedActions: ReadonlySet<string>;
|
|
31
|
+
readonly scopes: ReadonlySet<OperatorScope>;
|
|
32
|
+
readonly credential: PrincipalCredential;
|
|
33
|
+
readonly rateLimit: RateLimitRule | null;
|
|
34
|
+
}
|
|
35
|
+
/** The one caller a configuration without a principals file has. */
|
|
36
|
+
export declare const LEGACY_CALLER_ID = "legacy-caller";
|
|
37
|
+
/** One credential kind's own shape, for a lookup that narrowed to it. */
|
|
38
|
+
type CredentialOf<TKind extends PrincipalCredential["kind"]> = Extract<PrincipalCredential, {
|
|
39
|
+
readonly kind: TKind;
|
|
40
|
+
}>;
|
|
41
|
+
export type Comparator = (a: Uint8Array, b: Uint8Array) => boolean;
|
|
42
|
+
export interface RegistryContext {
|
|
43
|
+
readonly registeredActions: Iterable<string>;
|
|
44
|
+
readonly jwtConfigured: boolean;
|
|
45
|
+
readonly mutualTls: boolean;
|
|
46
|
+
}
|
|
47
|
+
export interface LegacyContext {
|
|
48
|
+
readonly tenantId: string;
|
|
49
|
+
readonly actor: PrincipalActor;
|
|
50
|
+
readonly registeredActions: Iterable<string>;
|
|
51
|
+
/** The caller token's current digest; read at each comparison so rotation is followed. */
|
|
52
|
+
readonly callerToken: () => Uint8Array;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Who may call this process and as what. Built once, from the principals
|
|
56
|
+
* file or from the legacy caller the configuration names, and never changed
|
|
57
|
+
* while running. A bearer lookup hashes what was presented and compares it
|
|
58
|
+
* with every bearer digest in constant time, without stopping at a match,
|
|
59
|
+
* so timing says nothing about which principal, if any, it was.
|
|
60
|
+
*/
|
|
61
|
+
export declare class PrincipalRegistry {
|
|
62
|
+
private readonly principals;
|
|
63
|
+
readonly legacy: boolean;
|
|
64
|
+
private readonly compare;
|
|
65
|
+
private readonly byId;
|
|
66
|
+
constructor(principals: readonly Principal[], legacy: boolean, compare?: Comparator);
|
|
67
|
+
/** The principals a file names, checked against what this process can run and verify. */
|
|
68
|
+
static fromEntries(entries: readonly PrincipalEntry[], context: RegistryContext, compare?: Comparator): PrincipalRegistry;
|
|
69
|
+
/** The legacy caller: one proposer, every registered action, the caller token as its credential. */
|
|
70
|
+
static legacy(context: LegacyContext, compare?: Comparator): PrincipalRegistry;
|
|
71
|
+
get size(): number;
|
|
72
|
+
get all(): readonly Principal[];
|
|
73
|
+
get proposers(): readonly Principal[];
|
|
74
|
+
get operators(): readonly Principal[];
|
|
75
|
+
principal(id: string): Principal | null;
|
|
76
|
+
/**
|
|
77
|
+
* The principals holding one kind of credential, narrowed once here rather
|
|
78
|
+
* than by a kind check inside every lookup. A lookup then reads only the
|
|
79
|
+
* fields its own kind has, and there is one place where the narrowing
|
|
80
|
+
* could be wrong.
|
|
81
|
+
*/
|
|
82
|
+
private ofKind;
|
|
83
|
+
/** Every bearer digest is compared, in constant time, whether or not an earlier one matched. */
|
|
84
|
+
byBearerDigest(presented: string): Principal | null;
|
|
85
|
+
/** The principal a client certificate names by SAN URI, and pins by fingerprint when the file says so. */
|
|
86
|
+
byCertificate(sanUris: readonly string[], fingerprint: string): Principal | null;
|
|
87
|
+
issuerKnown(issuer: string): boolean;
|
|
88
|
+
/**
|
|
89
|
+
* The principal a workload token names, with its own credential, so the
|
|
90
|
+
* caller reads the issuer, audience and required claims without narrowing
|
|
91
|
+
* a second time.
|
|
92
|
+
*/
|
|
93
|
+
byJwt(issuer: string, subject: string): {
|
|
94
|
+
readonly principal: Principal;
|
|
95
|
+
readonly credential: CredentialOf<"WORKLOAD_JWT">;
|
|
96
|
+
} | null;
|
|
97
|
+
/** The audiences named per principal, so the verifier accepts each; the global one is the default. */
|
|
98
|
+
audiences(): readonly string[];
|
|
99
|
+
private static credential;
|
|
100
|
+
}
|
|
101
|
+
export {};
|
|
102
|
+
//# sourceMappingURL=PrincipalRegistry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PrincipalRegistry.d.ts","sourceRoot":"","sources":["../../src/identity/PrincipalRegistry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
import { createHash, timingSafeEqual } from "node:crypto";
|
|
2
|
+
import { normaliseFingerprint } from "./PeerIdentity.js";
|
|
3
|
+
import { PrincipalsError, } from "./PrincipalsFile.js";
|
|
4
|
+
import { RateLimiter } from "./RateLimiter.js";
|
|
5
|
+
/** The one caller a configuration without a principals file has. */
|
|
6
|
+
export const LEGACY_CALLER_ID = "legacy-caller";
|
|
7
|
+
/**
|
|
8
|
+
* Who may call this process and as what. Built once, from the principals
|
|
9
|
+
* file or from the legacy caller the configuration names, and never changed
|
|
10
|
+
* while running. A bearer lookup hashes what was presented and compares it
|
|
11
|
+
* with every bearer digest in constant time, without stopping at a match,
|
|
12
|
+
* so timing says nothing about which principal, if any, it was.
|
|
13
|
+
*/
|
|
14
|
+
export class PrincipalRegistry {
|
|
15
|
+
principals;
|
|
16
|
+
legacy;
|
|
17
|
+
compare;
|
|
18
|
+
byId;
|
|
19
|
+
constructor(principals, legacy, compare = (a, b) => timingSafeEqual(a, b)) {
|
|
20
|
+
this.principals = principals;
|
|
21
|
+
this.legacy = legacy;
|
|
22
|
+
this.compare = compare;
|
|
23
|
+
this.byId = new Map(principals.map((principal) => [principal.id, principal]));
|
|
24
|
+
}
|
|
25
|
+
/** The principals a file names, checked against what this process can run and verify. */
|
|
26
|
+
static fromEntries(entries, context, compare) {
|
|
27
|
+
const registered = new Set(context.registeredActions);
|
|
28
|
+
const principals = entries.map((entry) => {
|
|
29
|
+
if (entry.credential.kind === "WORKLOAD_JWT" && !context.jwtConfigured) {
|
|
30
|
+
throw new PrincipalsError("PRINCIPALS_JWT_UNCONFIGURED", entry.id);
|
|
31
|
+
}
|
|
32
|
+
if (entry.credential.kind === "MTLS" && !context.mutualTls) {
|
|
33
|
+
throw new PrincipalsError("PRINCIPALS_MTLS_UNCONFIGURED", entry.id);
|
|
34
|
+
}
|
|
35
|
+
if (entry.role === "PROPOSER") {
|
|
36
|
+
for (const action of entry.allowed_actions) {
|
|
37
|
+
if (!registered.has(action)) {
|
|
38
|
+
throw new PrincipalsError("PRINCIPALS_UNKNOWN_ACTION", `${entry.id}/${action}`);
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
// The two roles carry different things, so they are built separately
|
|
43
|
+
// rather than by three checks of the same field with a fallback each.
|
|
44
|
+
const shared = {
|
|
45
|
+
id: entry.id,
|
|
46
|
+
role: entry.role,
|
|
47
|
+
credential: PrincipalRegistry.credential(entry.credential),
|
|
48
|
+
rateLimit: entry.rate_limit === undefined
|
|
49
|
+
? null
|
|
50
|
+
: RateLimiter.parseRule(entry.rate_limit, `principals/${entry.id}/rate_limit`),
|
|
51
|
+
};
|
|
52
|
+
if (entry.role === "OPERATOR") {
|
|
53
|
+
return {
|
|
54
|
+
...shared,
|
|
55
|
+
tenantId: null,
|
|
56
|
+
actor: null,
|
|
57
|
+
allowedActions: new Set(),
|
|
58
|
+
scopes: new Set(entry.scopes),
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
return {
|
|
62
|
+
...shared,
|
|
63
|
+
tenantId: entry.tenant_id,
|
|
64
|
+
actor: {
|
|
65
|
+
id: entry.actor.id,
|
|
66
|
+
type: entry.actor.type,
|
|
67
|
+
// Absent rather than undefined: the actor travels inside the hashed
|
|
68
|
+
// intent, and a key with no value is not the same canonical form.
|
|
69
|
+
...(entry.actor.runtime === undefined ? {} : { runtime: entry.actor.runtime }),
|
|
70
|
+
},
|
|
71
|
+
allowedActions: new Set(entry.allowed_actions),
|
|
72
|
+
scopes: new Set(),
|
|
73
|
+
};
|
|
74
|
+
});
|
|
75
|
+
return new PrincipalRegistry(principals, false, compare);
|
|
76
|
+
}
|
|
77
|
+
/** The legacy caller: one proposer, every registered action, the caller token as its credential. */
|
|
78
|
+
static legacy(context, compare) {
|
|
79
|
+
return new PrincipalRegistry([
|
|
80
|
+
{
|
|
81
|
+
id: LEGACY_CALLER_ID,
|
|
82
|
+
role: "PROPOSER",
|
|
83
|
+
tenantId: context.tenantId,
|
|
84
|
+
actor: context.actor,
|
|
85
|
+
allowedActions: new Set(context.registeredActions),
|
|
86
|
+
scopes: new Set(),
|
|
87
|
+
credential: { kind: "BEARER", digest: context.callerToken },
|
|
88
|
+
rateLimit: null,
|
|
89
|
+
},
|
|
90
|
+
], true, compare);
|
|
91
|
+
}
|
|
92
|
+
get size() {
|
|
93
|
+
return this.principals.length;
|
|
94
|
+
}
|
|
95
|
+
get all() {
|
|
96
|
+
return this.principals;
|
|
97
|
+
}
|
|
98
|
+
get proposers() {
|
|
99
|
+
return this.principals.filter((principal) => principal.role === "PROPOSER");
|
|
100
|
+
}
|
|
101
|
+
get operators() {
|
|
102
|
+
return this.principals.filter((principal) => principal.role === "OPERATOR");
|
|
103
|
+
}
|
|
104
|
+
principal(id) {
|
|
105
|
+
return this.byId.get(id) ?? null;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* The principals holding one kind of credential, narrowed once here rather
|
|
109
|
+
* than by a kind check inside every lookup. A lookup then reads only the
|
|
110
|
+
* fields its own kind has, and there is one place where the narrowing
|
|
111
|
+
* could be wrong.
|
|
112
|
+
*/
|
|
113
|
+
ofKind(kind) {
|
|
114
|
+
const found = [];
|
|
115
|
+
for (const principal of this.principals) {
|
|
116
|
+
if (principal.credential.kind === kind) {
|
|
117
|
+
found.push({ principal, credential: principal.credential });
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
return found;
|
|
121
|
+
}
|
|
122
|
+
/** Every bearer digest is compared, in constant time, whether or not an earlier one matched. */
|
|
123
|
+
byBearerDigest(presented) {
|
|
124
|
+
const digest = createHash("sha256").update(presented).digest();
|
|
125
|
+
let found = null;
|
|
126
|
+
for (const { principal, credential } of this.ofKind("BEARER")) {
|
|
127
|
+
if (this.compare(digest, credential.digest()))
|
|
128
|
+
found = principal;
|
|
129
|
+
}
|
|
130
|
+
return found;
|
|
131
|
+
}
|
|
132
|
+
/** The principal a client certificate names by SAN URI, and pins by fingerprint when the file says so. */
|
|
133
|
+
byCertificate(sanUris, fingerprint) {
|
|
134
|
+
const presented = normaliseFingerprint(fingerprint);
|
|
135
|
+
for (const { principal, credential } of this.ofKind("MTLS")) {
|
|
136
|
+
if (!sanUris.includes(credential.sanUri))
|
|
137
|
+
continue;
|
|
138
|
+
if (credential.fingerprint !== null && credential.fingerprint !== presented)
|
|
139
|
+
return null;
|
|
140
|
+
return principal;
|
|
141
|
+
}
|
|
142
|
+
return null;
|
|
143
|
+
}
|
|
144
|
+
issuerKnown(issuer) {
|
|
145
|
+
return this.ofKind("WORKLOAD_JWT").some((entry) => entry.credential.issuer === issuer);
|
|
146
|
+
}
|
|
147
|
+
/**
|
|
148
|
+
* The principal a workload token names, with its own credential, so the
|
|
149
|
+
* caller reads the issuer, audience and required claims without narrowing
|
|
150
|
+
* a second time.
|
|
151
|
+
*/
|
|
152
|
+
byJwt(issuer, subject) {
|
|
153
|
+
for (const entry of this.ofKind("WORKLOAD_JWT")) {
|
|
154
|
+
if (entry.credential.issuer === issuer && entry.credential.subject === subject)
|
|
155
|
+
return entry;
|
|
156
|
+
}
|
|
157
|
+
return null;
|
|
158
|
+
}
|
|
159
|
+
/** The audiences named per principal, so the verifier accepts each; the global one is the default. */
|
|
160
|
+
audiences() {
|
|
161
|
+
const named = new Set();
|
|
162
|
+
for (const { credential } of this.ofKind("WORKLOAD_JWT")) {
|
|
163
|
+
if (credential.audience !== null)
|
|
164
|
+
named.add(credential.audience);
|
|
165
|
+
}
|
|
166
|
+
return [...named];
|
|
167
|
+
}
|
|
168
|
+
static credential(entry) {
|
|
169
|
+
switch (entry.kind) {
|
|
170
|
+
case "BEARER": {
|
|
171
|
+
const digest = Buffer.from(entry.token_sha256, "hex");
|
|
172
|
+
return { kind: "BEARER", digest: () => digest };
|
|
173
|
+
}
|
|
174
|
+
case "MTLS":
|
|
175
|
+
return {
|
|
176
|
+
kind: "MTLS",
|
|
177
|
+
sanUri: entry.san_uri,
|
|
178
|
+
fingerprint: entry.cert_fingerprint_sha256 ?? null,
|
|
179
|
+
};
|
|
180
|
+
case "WORKLOAD_JWT":
|
|
181
|
+
return {
|
|
182
|
+
kind: "WORKLOAD_JWT",
|
|
183
|
+
issuer: entry.issuer,
|
|
184
|
+
subject: entry.subject,
|
|
185
|
+
audience: entry.audience ?? null,
|
|
186
|
+
requiredClaims: entry.required_claims ?? {},
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
//# sourceMappingURL=PrincipalRegistry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PrincipalRegistry.js","sourceRoot":"","sources":["../../src/identity/PrincipalRegistry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const PRINCIPALS_VERSION = "agent-safe.principals/1";
|
|
3
|
+
export declare const MAX_PRINCIPALS = 200;
|
|
4
|
+
/** What an operator may do; each control route names the scope it needs. */
|
|
5
|
+
export declare const OPERATOR_SCOPES: readonly ["halt", "resume", "secrets.reload", "status", "metrics", "evidence"];
|
|
6
|
+
export type OperatorScope = (typeof OPERATOR_SCOPES)[number];
|
|
7
|
+
/**
|
|
8
|
+
* How a principal proves itself. The file holds identities and digests,
|
|
9
|
+
* never a token: a bearer credential is the SHA-256 of the token, a client
|
|
10
|
+
* certificate is named by its SAN URI and optionally pinned by fingerprint,
|
|
11
|
+
* and a workload token is named by issuer and subject.
|
|
12
|
+
*/
|
|
13
|
+
export declare const PrincipalCredentialSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
14
|
+
kind: z.ZodLiteral<"MTLS">;
|
|
15
|
+
san_uri: z.ZodString;
|
|
16
|
+
cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
|
|
17
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
18
|
+
kind: z.ZodLiteral<"WORKLOAD_JWT">;
|
|
19
|
+
issuer: z.ZodString;
|
|
20
|
+
subject: z.ZodString;
|
|
21
|
+
audience: z.ZodOptional<z.ZodString>;
|
|
22
|
+
required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
|
|
23
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
24
|
+
kind: z.ZodLiteral<"BEARER">;
|
|
25
|
+
token_sha256: z.ZodString;
|
|
26
|
+
}, z.core.$strict>], "kind">;
|
|
27
|
+
export declare const ProposerSchema: z.ZodObject<{
|
|
28
|
+
role: z.ZodLiteral<"PROPOSER">;
|
|
29
|
+
tenant_id: z.ZodString;
|
|
30
|
+
actor: z.ZodObject<{
|
|
31
|
+
id: z.ZodString;
|
|
32
|
+
type: z.ZodString;
|
|
33
|
+
runtime: z.ZodOptional<z.ZodString>;
|
|
34
|
+
}, z.core.$strict>;
|
|
35
|
+
allowed_actions: z.ZodArray<z.ZodString>;
|
|
36
|
+
id: z.ZodString;
|
|
37
|
+
credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
38
|
+
kind: z.ZodLiteral<"MTLS">;
|
|
39
|
+
san_uri: z.ZodString;
|
|
40
|
+
cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
|
|
41
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
42
|
+
kind: z.ZodLiteral<"WORKLOAD_JWT">;
|
|
43
|
+
issuer: z.ZodString;
|
|
44
|
+
subject: z.ZodString;
|
|
45
|
+
audience: z.ZodOptional<z.ZodString>;
|
|
46
|
+
required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
|
|
47
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
48
|
+
kind: z.ZodLiteral<"BEARER">;
|
|
49
|
+
token_sha256: z.ZodString;
|
|
50
|
+
}, z.core.$strict>], "kind">;
|
|
51
|
+
rate_limit: z.ZodOptional<z.ZodString>;
|
|
52
|
+
}, z.core.$strict>;
|
|
53
|
+
export declare const OperatorSchema: z.ZodObject<{
|
|
54
|
+
role: z.ZodLiteral<"OPERATOR">;
|
|
55
|
+
scopes: z.ZodArray<z.ZodEnum<{
|
|
56
|
+
status: "status";
|
|
57
|
+
"secrets.reload": "secrets.reload";
|
|
58
|
+
metrics: "metrics";
|
|
59
|
+
halt: "halt";
|
|
60
|
+
resume: "resume";
|
|
61
|
+
evidence: "evidence";
|
|
62
|
+
}>>;
|
|
63
|
+
id: z.ZodString;
|
|
64
|
+
credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
65
|
+
kind: z.ZodLiteral<"MTLS">;
|
|
66
|
+
san_uri: z.ZodString;
|
|
67
|
+
cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
|
|
68
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
69
|
+
kind: z.ZodLiteral<"WORKLOAD_JWT">;
|
|
70
|
+
issuer: z.ZodString;
|
|
71
|
+
subject: z.ZodString;
|
|
72
|
+
audience: z.ZodOptional<z.ZodString>;
|
|
73
|
+
required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
|
|
74
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
75
|
+
kind: z.ZodLiteral<"BEARER">;
|
|
76
|
+
token_sha256: z.ZodString;
|
|
77
|
+
}, z.core.$strict>], "kind">;
|
|
78
|
+
rate_limit: z.ZodOptional<z.ZodString>;
|
|
79
|
+
}, z.core.$strict>;
|
|
80
|
+
export declare const PrincipalsFileSchema: z.ZodObject<{
|
|
81
|
+
version: z.ZodLiteral<"agent-safe.principals/1">;
|
|
82
|
+
principals: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
83
|
+
role: z.ZodLiteral<"PROPOSER">;
|
|
84
|
+
tenant_id: z.ZodString;
|
|
85
|
+
actor: z.ZodObject<{
|
|
86
|
+
id: z.ZodString;
|
|
87
|
+
type: z.ZodString;
|
|
88
|
+
runtime: z.ZodOptional<z.ZodString>;
|
|
89
|
+
}, z.core.$strict>;
|
|
90
|
+
allowed_actions: z.ZodArray<z.ZodString>;
|
|
91
|
+
id: z.ZodString;
|
|
92
|
+
credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
93
|
+
kind: z.ZodLiteral<"MTLS">;
|
|
94
|
+
san_uri: z.ZodString;
|
|
95
|
+
cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
|
|
96
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
97
|
+
kind: z.ZodLiteral<"WORKLOAD_JWT">;
|
|
98
|
+
issuer: z.ZodString;
|
|
99
|
+
subject: z.ZodString;
|
|
100
|
+
audience: z.ZodOptional<z.ZodString>;
|
|
101
|
+
required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
|
|
102
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
103
|
+
kind: z.ZodLiteral<"BEARER">;
|
|
104
|
+
token_sha256: z.ZodString;
|
|
105
|
+
}, z.core.$strict>], "kind">;
|
|
106
|
+
rate_limit: z.ZodOptional<z.ZodString>;
|
|
107
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
108
|
+
role: z.ZodLiteral<"OPERATOR">;
|
|
109
|
+
scopes: z.ZodArray<z.ZodEnum<{
|
|
110
|
+
status: "status";
|
|
111
|
+
"secrets.reload": "secrets.reload";
|
|
112
|
+
metrics: "metrics";
|
|
113
|
+
halt: "halt";
|
|
114
|
+
resume: "resume";
|
|
115
|
+
evidence: "evidence";
|
|
116
|
+
}>>;
|
|
117
|
+
id: z.ZodString;
|
|
118
|
+
credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
119
|
+
kind: z.ZodLiteral<"MTLS">;
|
|
120
|
+
san_uri: z.ZodString;
|
|
121
|
+
cert_fingerprint_sha256: z.ZodOptional<z.ZodString>;
|
|
122
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
123
|
+
kind: z.ZodLiteral<"WORKLOAD_JWT">;
|
|
124
|
+
issuer: z.ZodString;
|
|
125
|
+
subject: z.ZodString;
|
|
126
|
+
audience: z.ZodOptional<z.ZodString>;
|
|
127
|
+
required_claims: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
|
|
128
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
129
|
+
kind: z.ZodLiteral<"BEARER">;
|
|
130
|
+
token_sha256: z.ZodString;
|
|
131
|
+
}, z.core.$strict>], "kind">;
|
|
132
|
+
rate_limit: z.ZodOptional<z.ZodString>;
|
|
133
|
+
}, z.core.$strict>], "role">>;
|
|
134
|
+
}, z.core.$strict>;
|
|
135
|
+
export type PrincipalEntry = z.infer<typeof PrincipalsFileSchema>["principals"][number];
|
|
136
|
+
export type PrincipalCredentialEntry = z.infer<typeof PrincipalCredentialSchema>;
|
|
137
|
+
/** A refusal to load principals: the code and the entry or path it concerns, never a value. */
|
|
138
|
+
export declare class PrincipalsError extends Error {
|
|
139
|
+
readonly code: string;
|
|
140
|
+
readonly subject: string | null;
|
|
141
|
+
constructor(code: string, subject?: string | null);
|
|
142
|
+
}
|
|
143
|
+
/** The identity a credential asserts; two principals may never share one. */
|
|
144
|
+
export declare function credentialIdentity(credential: PrincipalCredentialEntry): string;
|
|
145
|
+
/**
|
|
146
|
+
* Parses and checks a principals file: the schema, then no duplicate id and
|
|
147
|
+
* no credential identity claimed twice. What it cannot check here, that
|
|
148
|
+
* every allowed action is registered and every credential kind has what it
|
|
149
|
+
* needs, the registry checks when it is built.
|
|
150
|
+
*/
|
|
151
|
+
export declare function parsePrincipalsFile(text: string): readonly PrincipalEntry[];
|
|
152
|
+
//# sourceMappingURL=PrincipalsFile.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PrincipalsFile.d.ts","sourceRoot":"","sources":["../../src/identity/PrincipalsFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,4EAA4E;AAC5E,eAAO,MAAM,eAAe,gFAOlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAU7D;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;4BAmBpC,CAAC;AASH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;kBAMzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEjF,+FAA+F;AAC/F,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,MAAM,GAAG,IAAI;gBADtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,GAAG,IAAW;CAKhD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,wBAAwB,GAAG,MAAM,CAS/E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CA0B3E"}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export const PRINCIPALS_VERSION = "agent-safe.principals/1";
|
|
3
|
+
export const MAX_PRINCIPALS = 200;
|
|
4
|
+
/** What an operator may do; each control route names the scope it needs. */
|
|
5
|
+
export const OPERATOR_SCOPES = [
|
|
6
|
+
"halt",
|
|
7
|
+
"resume",
|
|
8
|
+
"secrets.reload",
|
|
9
|
+
"status",
|
|
10
|
+
"metrics",
|
|
11
|
+
"evidence",
|
|
12
|
+
];
|
|
13
|
+
const identifier = z.string().trim().min(1).max(200);
|
|
14
|
+
const hex64 = z.string().regex(/^[0-9a-f]{64}$/);
|
|
15
|
+
// Bounded here, and read as a rule by the registry: `RateLimiter.parseRule`
|
|
16
|
+
// is what a rate rule means, and its refusal names the principal by id
|
|
17
|
+
// rather than by its position in the file.
|
|
18
|
+
const rateLimit = z.string().trim().min(1).max(20);
|
|
19
|
+
const claimValue = z.union([z.string().max(500), z.number(), z.boolean()]);
|
|
20
|
+
/**
|
|
21
|
+
* How a principal proves itself. The file holds identities and digests,
|
|
22
|
+
* never a token: a bearer credential is the SHA-256 of the token, a client
|
|
23
|
+
* certificate is named by its SAN URI and optionally pinned by fingerprint,
|
|
24
|
+
* and a workload token is named by issuer and subject.
|
|
25
|
+
*/
|
|
26
|
+
export const PrincipalCredentialSchema = z.discriminatedUnion("kind", [
|
|
27
|
+
z.strictObject({
|
|
28
|
+
kind: z.literal("MTLS"),
|
|
29
|
+
san_uri: z
|
|
30
|
+
.string()
|
|
31
|
+
.trim()
|
|
32
|
+
.min(1)
|
|
33
|
+
.max(500)
|
|
34
|
+
.regex(/^[a-z][a-z0-9+.-]*:/i),
|
|
35
|
+
cert_fingerprint_sha256: hex64.optional(),
|
|
36
|
+
}),
|
|
37
|
+
z.strictObject({
|
|
38
|
+
kind: z.literal("WORKLOAD_JWT"),
|
|
39
|
+
issuer: z.string().trim().min(1).max(500),
|
|
40
|
+
subject: z.string().trim().min(1).max(500),
|
|
41
|
+
audience: z.string().trim().min(1).max(200).optional(),
|
|
42
|
+
required_claims: z.record(z.string().min(1).max(200), claimValue).optional(),
|
|
43
|
+
}),
|
|
44
|
+
z.strictObject({ kind: z.literal("BEARER"), token_sha256: hex64 }),
|
|
45
|
+
]);
|
|
46
|
+
const common = {
|
|
47
|
+
id: identifier,
|
|
48
|
+
credential: PrincipalCredentialSchema,
|
|
49
|
+
/** `<count>/<seconds>`: how many requests this principal may make per window. */
|
|
50
|
+
rate_limit: rateLimit.optional(),
|
|
51
|
+
};
|
|
52
|
+
export const ProposerSchema = z.strictObject({
|
|
53
|
+
...common,
|
|
54
|
+
role: z.literal("PROPOSER"),
|
|
55
|
+
tenant_id: z.string().uuid(),
|
|
56
|
+
actor: z.strictObject({ id: identifier, type: identifier, runtime: identifier.optional() }),
|
|
57
|
+
allowed_actions: z.array(z.string().trim().min(1).max(120)).min(1).max(50),
|
|
58
|
+
});
|
|
59
|
+
export const OperatorSchema = z.strictObject({
|
|
60
|
+
...common,
|
|
61
|
+
role: z.literal("OPERATOR"),
|
|
62
|
+
scopes: z.array(z.enum(OPERATOR_SCOPES)).min(1).max(OPERATOR_SCOPES.length),
|
|
63
|
+
});
|
|
64
|
+
export const PrincipalsFileSchema = z.strictObject({
|
|
65
|
+
version: z.literal(PRINCIPALS_VERSION),
|
|
66
|
+
principals: z
|
|
67
|
+
.array(z.discriminatedUnion("role", [ProposerSchema, OperatorSchema]))
|
|
68
|
+
.min(1)
|
|
69
|
+
.max(MAX_PRINCIPALS),
|
|
70
|
+
});
|
|
71
|
+
/** A refusal to load principals: the code and the entry or path it concerns, never a value. */
|
|
72
|
+
export class PrincipalsError extends Error {
|
|
73
|
+
code;
|
|
74
|
+
subject;
|
|
75
|
+
constructor(code, subject = null) {
|
|
76
|
+
super(subject === null ? code : `${code}: ${subject}`);
|
|
77
|
+
this.code = code;
|
|
78
|
+
this.subject = subject;
|
|
79
|
+
this.name = "PrincipalsError";
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
/** The identity a credential asserts; two principals may never share one. */
|
|
83
|
+
export function credentialIdentity(credential) {
|
|
84
|
+
switch (credential.kind) {
|
|
85
|
+
case "BEARER":
|
|
86
|
+
return `BEARER:${credential.token_sha256}`;
|
|
87
|
+
case "MTLS":
|
|
88
|
+
return `MTLS:${credential.san_uri}`;
|
|
89
|
+
case "WORKLOAD_JWT":
|
|
90
|
+
return `WORKLOAD_JWT:${credential.issuer}|${credential.subject}`;
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Parses and checks a principals file: the schema, then no duplicate id and
|
|
95
|
+
* no credential identity claimed twice. What it cannot check here, that
|
|
96
|
+
* every allowed action is registered and every credential kind has what it
|
|
97
|
+
* needs, the registry checks when it is built.
|
|
98
|
+
*/
|
|
99
|
+
export function parsePrincipalsFile(text) {
|
|
100
|
+
let parsed;
|
|
101
|
+
try {
|
|
102
|
+
parsed = JSON.parse(text);
|
|
103
|
+
}
|
|
104
|
+
catch {
|
|
105
|
+
throw new PrincipalsError("PRINCIPALS_INVALID", "not JSON");
|
|
106
|
+
}
|
|
107
|
+
const result = PrincipalsFileSchema.safeParse(parsed);
|
|
108
|
+
if (!result.success) {
|
|
109
|
+
const issue = result.error.issues[0];
|
|
110
|
+
throw new PrincipalsError("PRINCIPALS_INVALID", issue === undefined ? null : issue.path.join("."));
|
|
111
|
+
}
|
|
112
|
+
const ids = new Set();
|
|
113
|
+
const identities = new Set();
|
|
114
|
+
for (const entry of result.data.principals) {
|
|
115
|
+
if (ids.has(entry.id))
|
|
116
|
+
throw new PrincipalsError("PRINCIPALS_DUPLICATE_ID", entry.id);
|
|
117
|
+
ids.add(entry.id);
|
|
118
|
+
const identity = credentialIdentity(entry.credential);
|
|
119
|
+
if (identities.has(identity))
|
|
120
|
+
throw new PrincipalsError("PRINCIPALS_CREDENTIAL_SHARED", entry.id);
|
|
121
|
+
identities.add(identity);
|
|
122
|
+
}
|
|
123
|
+
return result.data.principals;
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=PrincipalsFile.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PrincipalsFile.js","sourceRoot":"","sources":["../../src/identity/PrincipalsFile.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
export interface RateLimitRule {
|
|
2
|
+
readonly count: number;
|
|
3
|
+
readonly windowSeconds: number;
|
|
4
|
+
}
|
|
5
|
+
export interface LockoutRule {
|
|
6
|
+
readonly failures: number;
|
|
7
|
+
readonly windowSeconds: number;
|
|
8
|
+
readonly lockSeconds: number;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* `<count>/<seconds>`, the one definition of a rate rule in this package. The
|
|
12
|
+
* principals file validates a rule by parsing it through `parseRule` rather
|
|
13
|
+
* than restating this pattern, so there is no second copy to drift from it.
|
|
14
|
+
*/
|
|
15
|
+
export declare const RATE_RULE_PATTERN: RegExp;
|
|
16
|
+
/**
|
|
17
|
+
* Sliding windows keyed by principal id, plus one key for requests that
|
|
18
|
+
* never became a principal. Memory is bounded by the registry: a key holds
|
|
19
|
+
* at most its rule's count of timestamps, and there is no key a caller can
|
|
20
|
+
* invent. A lockout engages when a principal's authentication failures reach
|
|
21
|
+
* the rule inside its window, and ends only when the lock expires or the
|
|
22
|
+
* process restarts.
|
|
23
|
+
*/
|
|
24
|
+
export declare class RateLimiter {
|
|
25
|
+
private readonly clock;
|
|
26
|
+
private readonly hits;
|
|
27
|
+
private readonly failures;
|
|
28
|
+
private readonly locks;
|
|
29
|
+
constructor(clock?: () => number);
|
|
30
|
+
/** `<count>/<seconds>`; a refusal names the variable. */
|
|
31
|
+
static parseRule(text: string, key: string): RateLimitRule;
|
|
32
|
+
/** `<failures>/<seconds>/<lock seconds>`; zero failures disables the lockout. */
|
|
33
|
+
static parseLockout(text: string, key: string): LockoutRule | null;
|
|
34
|
+
/** Whether the key has room under the rule right now, without taking any. */
|
|
35
|
+
exhausted(key: string, rule: RateLimitRule): boolean;
|
|
36
|
+
/** Takes one request from the key's window; false when the window is full. */
|
|
37
|
+
allow(key: string, rule: RateLimitRule): boolean;
|
|
38
|
+
/** Records an authentication failure; true when this one engaged the lock. */
|
|
39
|
+
recordFailure(key: string, rule: LockoutRule | null): boolean;
|
|
40
|
+
locked(key: string): boolean;
|
|
41
|
+
private recent;
|
|
42
|
+
}
|
|
43
|
+
//# sourceMappingURL=RateLimiter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/identity/RateLimiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAqC,CAAC;AAGpE;;;;;;;GAOG;AACH,qBAAa,WAAW;IAKH,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;gBAEf,KAAK,GAAE,MAAM,MAAyB;IAE1E,yDAAyD;WAC3C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAMjE,iFAAiF;WACnE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUzE,6EAA6E;IACtE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO;IAI3D,8EAA8E;IACvE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO;IAQvD,8EAA8E;IACvE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO;IAW7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQnC,OAAO,CAAC,MAAM;CAMf"}
|