@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,46 @@
|
|
|
1
|
+
import type { FetchLike } from "../handlers/HandlerRegistration.js";
|
|
2
|
+
import type { InterceptedRequest } from "./InterceptedRequest.js";
|
|
3
|
+
/** What came back from the upstream: the status, the headers a client may see, the bytes. */
|
|
4
|
+
export interface UpstreamResult {
|
|
5
|
+
readonly status: number;
|
|
6
|
+
readonly headers: readonly (readonly [string, string])[];
|
|
7
|
+
readonly body: Buffer;
|
|
8
|
+
}
|
|
9
|
+
/** Thrown when the upstream's response body is longer than the gateway relays. */
|
|
10
|
+
export declare class UpstreamResponseTooLarge extends Error {
|
|
11
|
+
constructor();
|
|
12
|
+
}
|
|
13
|
+
export interface UpstreamOptions {
|
|
14
|
+
readonly url: string;
|
|
15
|
+
readonly timeoutMs: number;
|
|
16
|
+
readonly maxResponseBytes: number;
|
|
17
|
+
readonly fetch: FetchLike;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* The one way the gateway reaches the upstream. It rebuilds the request
|
|
21
|
+
* from what it is given: the upstream origin from the configuration, the
|
|
22
|
+
* path and query from the caller, the client's headers minus the ones that
|
|
23
|
+
* belong to a hop, the body bytes verbatim. Redirects are relayed, never
|
|
24
|
+
* followed, so the client, and not this process, decides where to go next.
|
|
25
|
+
*/
|
|
26
|
+
export declare class Upstream {
|
|
27
|
+
private readonly options;
|
|
28
|
+
private readonly origin;
|
|
29
|
+
constructor(options: UpstreamOptions);
|
|
30
|
+
get url(): string;
|
|
31
|
+
get timeoutMs(): number;
|
|
32
|
+
/** The upstream URL for a path and query, under the configured base path. */
|
|
33
|
+
target(path: string, search: string): string;
|
|
34
|
+
/** The headers the upstream receives for a client's request, plus what the gateway adds. */
|
|
35
|
+
headersFor(request: InterceptedRequest, extra?: Readonly<Record<string, string>>): Record<string, string>;
|
|
36
|
+
/**
|
|
37
|
+
* Sends one request and reads the whole answer, bounded. A transport
|
|
38
|
+
* failure throws; the caller decides what a failure after dispatch means.
|
|
39
|
+
*/
|
|
40
|
+
send(method: string, path: string, search: string, headers: Readonly<Record<string, string>>, body: Buffer, signal: AbortSignal): Promise<UpstreamResult>;
|
|
41
|
+
/** The whole body, or a refusal once it passes the bound; never a partial relay. */
|
|
42
|
+
private static read;
|
|
43
|
+
/** The signal for one send: the configured ceiling, or a tighter budget the caller holds. */
|
|
44
|
+
signal(budgetMs?: number): AbortSignal;
|
|
45
|
+
}
|
|
46
|
+
//# sourceMappingURL=Upstream.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Upstream.d.ts","sourceRoot":"","sources":["../../src/gateway/Upstream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,kFAAkF;AAClF,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AA+BD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,qBAAa,QAAQ;IAGA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAM;gBAEO,OAAO,EAAE,eAAe;IAI5D,IAAW,GAAG,IAAI,MAAM,CAEvB;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,6EAA6E;IACtE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAKnD,4FAA4F;IACrF,UAAU,CACf,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAsCzB;;;OAGG;IACU,IAAI,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC;IA8B1B,oFAAoF;mBAC/D,IAAI;IAoBzB,6FAA6F;IACtF,MAAM,CAAC,QAAQ,GAAE,MAA+B,GAAG,WAAW;CAGtE"}
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
/** Thrown when the upstream's response body is longer than the gateway relays. */
|
|
2
|
+
export class UpstreamResponseTooLarge extends Error {
|
|
3
|
+
constructor() {
|
|
4
|
+
super("UPSTREAM_RESPONSE_TOO_LARGE");
|
|
5
|
+
this.name = "UpstreamResponseTooLarge";
|
|
6
|
+
}
|
|
7
|
+
}
|
|
8
|
+
/** Headers that describe one hop and are never carried to the next. */
|
|
9
|
+
const HOP_BY_HOP = new Set([
|
|
10
|
+
"connection",
|
|
11
|
+
"keep-alive",
|
|
12
|
+
"proxy-authenticate",
|
|
13
|
+
"proxy-authorization",
|
|
14
|
+
"proxy-connection",
|
|
15
|
+
"te",
|
|
16
|
+
"trailer",
|
|
17
|
+
"transfer-encoding",
|
|
18
|
+
"upgrade",
|
|
19
|
+
]);
|
|
20
|
+
/** Request headers the gateway sets itself, so a client's value never stands in for them. */
|
|
21
|
+
const REQUEST_OWNED = new Set([
|
|
22
|
+
"host",
|
|
23
|
+
"content-length",
|
|
24
|
+
"expect",
|
|
25
|
+
"accept-encoding",
|
|
26
|
+
"x-forwarded-proto",
|
|
27
|
+
"x-forwarded-host",
|
|
28
|
+
]);
|
|
29
|
+
/** Response headers the relay recomputes, because it relays decoded bytes of a known length. */
|
|
30
|
+
const RESPONSE_OWNED = new Set(["content-length", "content-encoding"]);
|
|
31
|
+
const BODYLESS_METHODS = new Set(["GET", "HEAD"]);
|
|
32
|
+
/** The headers the gateway sends the upstream about the authorization; a caller may not set them. */
|
|
33
|
+
const EVIDENCE_HEADER_PREFIX = "x-agent-safe-";
|
|
34
|
+
/** The headers the gateway sends the caller about the decision; an upstream may not set them. */
|
|
35
|
+
const RELAY_HEADER_PREFIX = "agentsafe-";
|
|
36
|
+
/**
|
|
37
|
+
* The one way the gateway reaches the upstream. It rebuilds the request
|
|
38
|
+
* from what it is given: the upstream origin from the configuration, the
|
|
39
|
+
* path and query from the caller, the client's headers minus the ones that
|
|
40
|
+
* belong to a hop, the body bytes verbatim. Redirects are relayed, never
|
|
41
|
+
* followed, so the client, and not this process, decides where to go next.
|
|
42
|
+
*/
|
|
43
|
+
export class Upstream {
|
|
44
|
+
options;
|
|
45
|
+
origin;
|
|
46
|
+
constructor(options) {
|
|
47
|
+
this.options = options;
|
|
48
|
+
this.origin = new URL(options.url);
|
|
49
|
+
}
|
|
50
|
+
get url() {
|
|
51
|
+
return this.options.url;
|
|
52
|
+
}
|
|
53
|
+
get timeoutMs() {
|
|
54
|
+
return this.options.timeoutMs;
|
|
55
|
+
}
|
|
56
|
+
/** The upstream URL for a path and query, under the configured base path. */
|
|
57
|
+
target(path, search) {
|
|
58
|
+
const base = this.origin.pathname.replace(/\/$/, "");
|
|
59
|
+
return `${this.origin.origin}${base}${path}${search}`;
|
|
60
|
+
}
|
|
61
|
+
/** The headers the upstream receives for a client's request, plus what the gateway adds. */
|
|
62
|
+
headersFor(request, extra = {}) {
|
|
63
|
+
const connectionNamed = new Set((request.headers["connection"] ?? "")
|
|
64
|
+
.split(",")
|
|
65
|
+
.map((name) => name.trim().toLowerCase())
|
|
66
|
+
.filter((name) => name !== ""));
|
|
67
|
+
const headers = {};
|
|
68
|
+
for (const [name, value] of Object.entries(request.headers)) {
|
|
69
|
+
// The evidence headers are the gateway's own statement to the upstream;
|
|
70
|
+
// a caller's spelling of one is dropped so it can never be mistaken for it.
|
|
71
|
+
if (HOP_BY_HOP.has(name) ||
|
|
72
|
+
REQUEST_OWNED.has(name) ||
|
|
73
|
+
connectionNamed.has(name) ||
|
|
74
|
+
name.startsWith(EVIDENCE_HEADER_PREFIX)) {
|
|
75
|
+
continue;
|
|
76
|
+
}
|
|
77
|
+
headers[name] = value;
|
|
78
|
+
}
|
|
79
|
+
const forwardedFor = request.headers["x-forwarded-for"];
|
|
80
|
+
if (request.remoteAddress !== null) {
|
|
81
|
+
headers["x-forwarded-for"] =
|
|
82
|
+
forwardedFor === undefined
|
|
83
|
+
? request.remoteAddress
|
|
84
|
+
: `${forwardedFor}, ${request.remoteAddress}`;
|
|
85
|
+
}
|
|
86
|
+
headers["x-forwarded-proto"] = request.encrypted ? "https" : "http";
|
|
87
|
+
if (request.headers["host"] !== undefined)
|
|
88
|
+
headers["x-forwarded-host"] = request.headers["host"];
|
|
89
|
+
// Identity between the gateway and the upstream: the bytes relayed are
|
|
90
|
+
// the bytes received, and no header describes an encoding they lack.
|
|
91
|
+
headers["accept-encoding"] = "identity";
|
|
92
|
+
for (const [name, value] of Object.entries(extra))
|
|
93
|
+
headers[name.toLowerCase()] = value;
|
|
94
|
+
return headers;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Sends one request and reads the whole answer, bounded. A transport
|
|
98
|
+
* failure throws; the caller decides what a failure after dispatch means.
|
|
99
|
+
*/
|
|
100
|
+
async send(method, path, search, headers, body, signal) {
|
|
101
|
+
const response = await this.options.fetch(this.target(path, search), {
|
|
102
|
+
method,
|
|
103
|
+
headers,
|
|
104
|
+
...(BODYLESS_METHODS.has(method) || body.length === 0 ? {} : { body: new Uint8Array(body) }),
|
|
105
|
+
redirect: "manual",
|
|
106
|
+
signal,
|
|
107
|
+
});
|
|
108
|
+
const relayed = [];
|
|
109
|
+
for (const [name, value] of response.headers) {
|
|
110
|
+
// Likewise on the way back: what the caller reads under `agentsafe-` is
|
|
111
|
+
// the gateway's, never the upstream's.
|
|
112
|
+
if (HOP_BY_HOP.has(name) ||
|
|
113
|
+
RESPONSE_OWNED.has(name) ||
|
|
114
|
+
name === "set-cookie" ||
|
|
115
|
+
name.startsWith(RELAY_HEADER_PREFIX)) {
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
relayed.push([name, value]);
|
|
119
|
+
}
|
|
120
|
+
for (const cookie of response.headers.getSetCookie())
|
|
121
|
+
relayed.push(["set-cookie", cookie]);
|
|
122
|
+
return {
|
|
123
|
+
status: response.status,
|
|
124
|
+
headers: relayed,
|
|
125
|
+
body: await Upstream.read(response, this.options.maxResponseBytes),
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
/** The whole body, or a refusal once it passes the bound; never a partial relay. */
|
|
129
|
+
static async read(response, maxBytes) {
|
|
130
|
+
if (response.body === null)
|
|
131
|
+
return Buffer.alloc(0);
|
|
132
|
+
const chunks = [];
|
|
133
|
+
let size = 0;
|
|
134
|
+
const reader = response.body.getReader();
|
|
135
|
+
try {
|
|
136
|
+
for (;;) {
|
|
137
|
+
const { done, value } = await reader.read();
|
|
138
|
+
if (done)
|
|
139
|
+
break;
|
|
140
|
+
size += value.byteLength;
|
|
141
|
+
if (size > maxBytes)
|
|
142
|
+
throw new UpstreamResponseTooLarge();
|
|
143
|
+
chunks.push(value);
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
finally {
|
|
147
|
+
reader.releaseLock();
|
|
148
|
+
if (size > maxBytes)
|
|
149
|
+
await response.body.cancel().catch(() => undefined);
|
|
150
|
+
}
|
|
151
|
+
return Buffer.concat(chunks);
|
|
152
|
+
}
|
|
153
|
+
/** The signal for one send: the configured ceiling, or a tighter budget the caller holds. */
|
|
154
|
+
signal(budgetMs = this.options.timeoutMs) {
|
|
155
|
+
return AbortSignal.timeout(Math.max(Math.min(budgetMs, this.options.timeoutMs), 1));
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
//# sourceMappingURL=Upstream.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Upstream.js","sourceRoot":"","sources":["../../src/gateway/Upstream.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { type ActionRegistry } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import type { DownstreamConfig } from "../config/ExecutorConfig.js";
|
|
3
|
+
import type { DownstreamCredential } from "../credential/DownstreamCredential.js";
|
|
4
|
+
import type { FetchLike, HandlerRegistration } from "./HandlerRegistration.js";
|
|
5
|
+
/**
|
|
6
|
+
* The reference handler. Everything registered here runs only behind a
|
|
7
|
+
* claimed single-use grant, with the parameters the authority evaluated and
|
|
8
|
+
* nothing the agent could add afterwards. It forwards the verified parameters
|
|
9
|
+
* to a configured downstream endpoint, carrying the headers the credential
|
|
10
|
+
* resolves at dispatch and the intent-bound idempotency key; an adopter
|
|
11
|
+
* replaces it with the handlers for their own provider, keeping the shape: a
|
|
12
|
+
* strict parameter schema, the side effect inside `dispatch.run`, and a
|
|
13
|
+
* read-only `reconcile`.
|
|
14
|
+
*/
|
|
15
|
+
export declare const FORWARD_REQUEST_ACTION = "forward_request";
|
|
16
|
+
/** Every action the reference registration registers, in the order `/ready` reports them. */
|
|
17
|
+
export declare const REGISTERED_ACTIONS: readonly string[];
|
|
18
|
+
/** What the executor reports about the downstream attempt: a status, never a body. */
|
|
19
|
+
export interface DownstreamResult {
|
|
20
|
+
readonly status: number;
|
|
21
|
+
readonly accepted: boolean;
|
|
22
|
+
}
|
|
23
|
+
export declare function registerHandlers(registry: ActionRegistry, downstream: DownstreamConfig, credential: DownstreamCredential, fetchImpl?: FetchLike): ActionRegistry;
|
|
24
|
+
/** The reference registration: the one forwarding handler, as a seam the executor accepts. */
|
|
25
|
+
export declare function forwardRequestHandlers(): HandlerRegistration;
|
|
26
|
+
//# sourceMappingURL=ForwardRequestHandler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ForwardRequestHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/ForwardRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,uCAAuC,CAAC;AAI/C,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA6B,CAAC;AAE9E,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAID,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,oBAAoB,EAChC,SAAS,GAAE,SAAiB,GAC3B,cAAc,CAoFhB;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { JsonObjectSchema, } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import { grantOf } from "../credential/GrantOf.js";
|
|
3
|
+
import { SignedRequestCredential } from "../credential/SignedRequestCredential.js";
|
|
4
|
+
import { dispatchBudgetMs, MonotonicDeadline } from "../time/MonotonicClock.js";
|
|
5
|
+
/**
|
|
6
|
+
* The reference handler. Everything registered here runs only behind a
|
|
7
|
+
* claimed single-use grant, with the parameters the authority evaluated and
|
|
8
|
+
* nothing the agent could add afterwards. It forwards the verified parameters
|
|
9
|
+
* to a configured downstream endpoint, carrying the headers the credential
|
|
10
|
+
* resolves at dispatch and the intent-bound idempotency key; an adopter
|
|
11
|
+
* replaces it with the handlers for their own provider, keeping the shape: a
|
|
12
|
+
* strict parameter schema, the side effect inside `dispatch.run`, and a
|
|
13
|
+
* read-only `reconcile`.
|
|
14
|
+
*/
|
|
15
|
+
export const FORWARD_REQUEST_ACTION = "forward_request";
|
|
16
|
+
/** Every action the reference registration registers, in the order `/ready` reports them. */
|
|
17
|
+
export const REGISTERED_ACTIONS = [FORWARD_REQUEST_ACTION];
|
|
18
|
+
export function registerHandlers(registry, downstream, credential, fetchImpl = fetch) {
|
|
19
|
+
const execute = async ({ intent, parameters, authorization, dispatch, }) => {
|
|
20
|
+
const body = JSON.stringify(parameters);
|
|
21
|
+
// The credential is resolved before the point of no return, so a token
|
|
22
|
+
// that cannot be obtained or a key that cannot sign is a failure before
|
|
23
|
+
// dispatch, never an unknown outcome; it exists only here, on the
|
|
24
|
+
// trusted side of the boundary, and only for this request.
|
|
25
|
+
const request = {
|
|
26
|
+
method: "POST",
|
|
27
|
+
url: downstream.url,
|
|
28
|
+
body,
|
|
29
|
+
idempotencyKey: dispatch.idempotencyKey,
|
|
30
|
+
intentHash: intent.intentHash,
|
|
31
|
+
grant: grantOf(authorization),
|
|
32
|
+
};
|
|
33
|
+
const credentialHeaders = await credential.headersFor(request);
|
|
34
|
+
// The provider is never given more time than the authorization has left:
|
|
35
|
+
// a slow call cannot outlive the permission it was made under, and the
|
|
36
|
+
// budget is monotonic, so correcting the wall clock cannot extend it.
|
|
37
|
+
const deadline = MonotonicDeadline.after(dispatchBudgetMs(downstream.timeoutMs, authorization));
|
|
38
|
+
return await dispatch.run(async () => {
|
|
39
|
+
// Everything after this line is the point of no return: a transport
|
|
40
|
+
// failure here is an unknown outcome, never a failure to retry.
|
|
41
|
+
const response = await fetchImpl(downstream.url, {
|
|
42
|
+
method: "POST",
|
|
43
|
+
headers: {
|
|
44
|
+
...credentialHeaders,
|
|
45
|
+
"content-type": "application/json",
|
|
46
|
+
// Every header a signing credential covers, with the value it
|
|
47
|
+
// signed: the key and intent hash, the grant and decision this
|
|
48
|
+
// dispatch executes under, and the authority's attestation of the
|
|
49
|
+
// claim when it gave one. The dossier id rides beside them.
|
|
50
|
+
...SignedRequestCredential.coveredHeaders(request),
|
|
51
|
+
"x-agent-safe-dossier-id": authorization.dossierId,
|
|
52
|
+
},
|
|
53
|
+
body,
|
|
54
|
+
signal: deadline.signal(),
|
|
55
|
+
});
|
|
56
|
+
await response.body?.cancel();
|
|
57
|
+
return { status: response.status, accepted: response.ok };
|
|
58
|
+
});
|
|
59
|
+
};
|
|
60
|
+
// Read-only: asks the downstream what it did with this idempotency key.
|
|
61
|
+
// It never sends the request again.
|
|
62
|
+
const reconcile = async ({ intent, idempotencyKey, }) => {
|
|
63
|
+
const url = (downstream.lookupUrl ?? "").replace("{idempotency_key}", encodeURIComponent(idempotencyKey));
|
|
64
|
+
const response = await fetchImpl(url, {
|
|
65
|
+
method: "GET",
|
|
66
|
+
headers: await credential.headersFor({
|
|
67
|
+
method: "GET",
|
|
68
|
+
url,
|
|
69
|
+
body: null,
|
|
70
|
+
idempotencyKey,
|
|
71
|
+
intentHash: intent.intentHash,
|
|
72
|
+
}),
|
|
73
|
+
signal: AbortSignal.timeout(downstream.timeoutMs),
|
|
74
|
+
});
|
|
75
|
+
await response.body?.cancel();
|
|
76
|
+
if (response.status === 404)
|
|
77
|
+
return { status: "NOT_EXECUTED" };
|
|
78
|
+
if (response.ok) {
|
|
79
|
+
return { status: "COMPLETED", result: { status: response.status, accepted: true } };
|
|
80
|
+
}
|
|
81
|
+
return { status: "UNKNOWN" };
|
|
82
|
+
};
|
|
83
|
+
const handler = {
|
|
84
|
+
parametersSchema: JsonObjectSchema,
|
|
85
|
+
execute,
|
|
86
|
+
...(downstream.lookupUrl === null ? {} : { reconcile }),
|
|
87
|
+
};
|
|
88
|
+
registry.register(FORWARD_REQUEST_ACTION, handler);
|
|
89
|
+
return registry;
|
|
90
|
+
}
|
|
91
|
+
/** The reference registration: the one forwarding handler, as a seam the executor accepts. */
|
|
92
|
+
export function forwardRequestHandlers() {
|
|
93
|
+
return ({ registry, downstream, credential, fetch: fetchImpl }) => {
|
|
94
|
+
registerHandlers(registry, downstream, credential, fetchImpl);
|
|
95
|
+
return REGISTERED_ACTIONS;
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=ForwardRequestHandler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ForwardRequestHandler.js","sourceRoot":"","sources":["../../src/handlers/ForwardRequestHandler.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { ActionRegistry } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import type { EffectEvidenceRegister } from "../adapters/EffectEvidenceRegister.js";
|
|
3
|
+
import type { BankingConfig, DownstreamConfig } from "../config/ExecutorConfig.js";
|
|
4
|
+
import type { DownstreamCredential } from "../credential/DownstreamCredential.js";
|
|
5
|
+
export type FetchLike = typeof fetch;
|
|
6
|
+
/**
|
|
7
|
+
* What a registration receives: the registry to fill, the downstream it
|
|
8
|
+
* targets, the credential that proves this process to the downstream, and
|
|
9
|
+
* the fetch it may use. A handler asks the credential for headers at the
|
|
10
|
+
* moment of dispatch and never holds a value of its own.
|
|
11
|
+
*/
|
|
12
|
+
export interface HandlerRegistrationContext {
|
|
13
|
+
readonly registry: ActionRegistry;
|
|
14
|
+
readonly downstream: DownstreamConfig;
|
|
15
|
+
readonly credential: DownstreamCredential;
|
|
16
|
+
readonly fetch: FetchLike;
|
|
17
|
+
/**
|
|
18
|
+
* Where a handler that observes an effect registers what it saw, so the
|
|
19
|
+
* verifier can finalize the grant with it. A handler that has no effect
|
|
20
|
+
* plane ignores it.
|
|
21
|
+
*/
|
|
22
|
+
readonly effects: EffectEvidenceRegister;
|
|
23
|
+
/**
|
|
24
|
+
* The banking family's settings, so an adapter takes its identity from the
|
|
25
|
+
* one place the executor already reports it from. A registration for
|
|
26
|
+
* another family ignores it.
|
|
27
|
+
*/
|
|
28
|
+
readonly banking: BankingConfig;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* The seam an adopter fills. It registers every action this process can run
|
|
32
|
+
* on the registry it is given and returns their names, in the order `/ready`
|
|
33
|
+
* reports them. The registry is sealed the moment it returns: nothing
|
|
34
|
+
* registered later, and nothing the agent names, can run.
|
|
35
|
+
*/
|
|
36
|
+
export type HandlerRegistration = (context: HandlerRegistrationContext) => readonly string[];
|
|
37
|
+
//# sourceMappingURL=HandlerRegistration.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HandlerRegistration.d.ts","sourceRoot":"","sources":["../../src/handlers/HandlerRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,0BAA0B,KAAK,SAAS,MAAM,EAAE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HandlerRegistration.js","sourceRoot":"","sources":["../../src/handlers/HandlerRegistration.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { ActionRegistry, type ActionHandler, type JsonObject } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import type { ExecutionJournal } from "../journal/ExecutionJournal.js";
|
|
3
|
+
/** The digest of what the handler is about to send: the canonical parameters. */
|
|
4
|
+
export declare function requestDigest(parameters: unknown): `sha256:${string}`;
|
|
5
|
+
/**
|
|
6
|
+
* The decorator that makes a claimed grant durable before anything can be
|
|
7
|
+
* dispatched. It runs inside the handler, after `SafeExecutor` consumed the
|
|
8
|
+
* grant and before the handler's own body, which is where the verified
|
|
9
|
+
* authorization exists and where a failure is still a failure *before*
|
|
10
|
+
* dispatch. A journal that cannot take the record throws here, the registry
|
|
11
|
+
* reports `FAILED_BEFORE_DISPATCH`, and `SafeExecutor` finalizes the attempt
|
|
12
|
+
* as `FAILED`: there is no side effect without a durable record of the claim,
|
|
13
|
+
* and the authority is told the attempt failed rather than being left to a
|
|
14
|
+
* lease timeout.
|
|
15
|
+
*/
|
|
16
|
+
export declare function journaledActionHandler<TParameters, TResult>(handler: ActionHandler<TParameters, TResult>, journal: () => ExecutionJournal | null): ActionHandler<TParameters, TResult>;
|
|
17
|
+
/**
|
|
18
|
+
* The registry the adopter's registration fills. Every handler it accepts is
|
|
19
|
+
* wrapped, so the durable claim is not something a registration can forget:
|
|
20
|
+
* an adopter writes an ordinary handler and the journal record happens
|
|
21
|
+
* anyway. `SafeExecutor` and the pipeline's own registry are untouched.
|
|
22
|
+
*/
|
|
23
|
+
export declare class JournaledRegistry extends ActionRegistry {
|
|
24
|
+
private readonly journal;
|
|
25
|
+
constructor(journal: () => ExecutionJournal | null);
|
|
26
|
+
register<TParameters, TResult>(action: string, handler: ActionHandler<TParameters, TResult>): this;
|
|
27
|
+
}
|
|
28
|
+
/** The principal a journal record names, when one is in scope. */
|
|
29
|
+
export declare function callerPrincipal(): string | null;
|
|
30
|
+
export type { JsonObject };
|
|
31
|
+
//# sourceMappingURL=JournaledActionHandler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"JournaledActionHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/JournaledActionHandler.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EAGd,KAAK,aAAa,EAClB,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,MAAM,EAAE,CAGrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,OAAO,EACzD,OAAO,EAAE,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,EAC5C,OAAO,EAAE,MAAM,gBAAgB,GAAG,IAAI,GACrC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAsBrC;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM,gBAAgB,GAAG,IAAI;IAI1D,QAAQ,CAAC,WAAW,EAAE,OAAO,EAC3C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,GAC3C,IAAI;CAGR;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { ActionRegistry, CanonicalIntentHasher, } from "@decionis/agent-safe-pipeline";
|
|
3
|
+
import { RequestContext } from "../http/RequestContext.js";
|
|
4
|
+
/** The digest of what the handler is about to send: the canonical parameters. */
|
|
5
|
+
export function requestDigest(parameters) {
|
|
6
|
+
const canonical = CanonicalIntentHasher.stringify((parameters ?? {}));
|
|
7
|
+
return `sha256:${createHash("sha256").update(canonical, "utf8").digest("hex")}`;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* The decorator that makes a claimed grant durable before anything can be
|
|
11
|
+
* dispatched. It runs inside the handler, after `SafeExecutor` consumed the
|
|
12
|
+
* grant and before the handler's own body, which is where the verified
|
|
13
|
+
* authorization exists and where a failure is still a failure *before*
|
|
14
|
+
* dispatch. A journal that cannot take the record throws here, the registry
|
|
15
|
+
* reports `FAILED_BEFORE_DISPATCH`, and `SafeExecutor` finalizes the attempt
|
|
16
|
+
* as `FAILED`: there is no side effect without a durable record of the claim,
|
|
17
|
+
* and the authority is told the attempt failed rather than being left to a
|
|
18
|
+
* lease timeout.
|
|
19
|
+
*/
|
|
20
|
+
export function journaledActionHandler(handler, journal) {
|
|
21
|
+
const execute = async (context) => {
|
|
22
|
+
const target = journal();
|
|
23
|
+
if (target !== null) {
|
|
24
|
+
await target.append({
|
|
25
|
+
record: "GRANT_CLAIMED",
|
|
26
|
+
at: new Date().toISOString(),
|
|
27
|
+
intent_id: context.intent.intent.intentId,
|
|
28
|
+
intent_hash: context.intent.intentHash,
|
|
29
|
+
idempotency_key: context.dispatch.idempotencyKey,
|
|
30
|
+
grant_id: context.authorization.grantId,
|
|
31
|
+
expires_at: context.authorization.expiresAt,
|
|
32
|
+
request_digest: requestDigest(context.parameters),
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
return await handler.execute(context);
|
|
36
|
+
};
|
|
37
|
+
return {
|
|
38
|
+
parametersSchema: handler.parametersSchema,
|
|
39
|
+
execute,
|
|
40
|
+
...(handler.reconcile === undefined ? {} : { reconcile: handler.reconcile.bind(handler) }),
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* The registry the adopter's registration fills. Every handler it accepts is
|
|
45
|
+
* wrapped, so the durable claim is not something a registration can forget:
|
|
46
|
+
* an adopter writes an ordinary handler and the journal record happens
|
|
47
|
+
* anyway. `SafeExecutor` and the pipeline's own registry are untouched.
|
|
48
|
+
*/
|
|
49
|
+
export class JournaledRegistry extends ActionRegistry {
|
|
50
|
+
journal;
|
|
51
|
+
constructor(journal) {
|
|
52
|
+
super();
|
|
53
|
+
this.journal = journal;
|
|
54
|
+
}
|
|
55
|
+
register(action, handler) {
|
|
56
|
+
return super.register(action, journaledActionHandler(handler, this.journal));
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
/** The principal a journal record names, when one is in scope. */
|
|
60
|
+
export function callerPrincipal() {
|
|
61
|
+
return RequestContext.current()?.principal ?? null;
|
|
62
|
+
}
|
|
63
|
+
//# sourceMappingURL=JournaledActionHandler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"JournaledActionHandler.js","sourceRoot":"","sources":["../../src/handlers/JournaledActionHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,cAAc,EACd,qBAAqB,GAKtB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,UAAmB;IAC/C,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,EAAE,CAAc,CAAC,CAAC;IACnF,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA4C,EAC5C,OAAsC;IAEtC,MAAM,OAAO,GAAG,KAAK,EAAE,OAA4C,EAAoB,EAAE;QACvF,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC;QACzB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,MAAM,CAAC;gBAClB,MAAM,EAAE,eAAe;gBACvB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ;gBACzC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;gBACtC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAChD,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO;gBACvC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,SAAS;gBAC3C,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC;IACF,OAAO;QACL,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACf;IAApC,YAAoC,OAAsC;QACxE,KAAK,EAAE,CAAC;QAD0B,YAAO,GAAP,OAAO,CAA+B;IAE1E,CAAC;IAEe,QAAQ,CACtB,MAAc,EACd,OAA4C;QAE5C,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/E,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,CAAC,OAAO,EAAE,EAAE,SAAS,IAAI,IAAI,CAAC;AACrD,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { AddressInfo } from "node:net";
|
|
2
|
+
import { type Authenticator } from "../identity/Authenticator.js";
|
|
3
|
+
import type { TrustedExecutorService } from "../service/TrustedExecutorService.js";
|
|
4
|
+
import type { TlsListener } from "./TlsListener.js";
|
|
5
|
+
export interface ExecutorHttpServerOptions {
|
|
6
|
+
/** The TLS listener; plaintext when null, which the configuration allows outside production only. */
|
|
7
|
+
readonly tls?: TlsListener | null;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* The process's one listener. Every route that is not public goes through
|
|
11
|
+
* the authenticator, which decides who the caller is and whether the route
|
|
12
|
+
* is theirs; the body is bounded before it is read; a failure is a status
|
|
13
|
+
* and a code, never a message, a stack, or anything from the request.
|
|
14
|
+
* Every authenticated request runs inside a request scope, so the evidence
|
|
15
|
+
* lines it causes name the principal.
|
|
16
|
+
*/
|
|
17
|
+
export declare class ExecutorHttpServer {
|
|
18
|
+
private readonly service;
|
|
19
|
+
private readonly authenticator;
|
|
20
|
+
private readonly server;
|
|
21
|
+
private readonly tls;
|
|
22
|
+
constructor(service: TrustedExecutorService, authenticator: Authenticator, options?: ExecutorHttpServerOptions);
|
|
23
|
+
listen(port: number, address: string): Promise<AddressInfo>;
|
|
24
|
+
close(): Promise<void>;
|
|
25
|
+
/** Replaces the TLS context from the current material; connections already open keep theirs. */
|
|
26
|
+
rotateTls(): void;
|
|
27
|
+
private handle;
|
|
28
|
+
private dispatch;
|
|
29
|
+
private static readJson;
|
|
30
|
+
private static reply;
|
|
31
|
+
private static replyText;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=ExecutorHttpServer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ExecutorHttpServer.d.ts","sourceRoot":"","sources":["../../src/http/ExecutorHttpServer.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AASnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,MAAM,WAAW,yBAAyB;IACxC,qGAAqG;IACrG,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAaD;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IALhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;gBAGtB,OAAO,EAAE,sBAAsB,EAC/B,aAAa,EAAE,aAAa,EAC7C,OAAO,GAAE,yBAA8B;IAY5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC,gGAAgG;IACzF,SAAS,IAAI,IAAI;YAKV,MAAM;YA8CN,QAAQ;mBAoED,QAAQ;IAwB7B,OAAO,CAAC,MAAM,CAAC,KAAK;IAYpB,OAAO,CAAC,MAAM,CAAC,SAAS;CAMzB"}
|